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This month, QL World 1s co- 
operating with newly-formed 
QL special interest group 
OLAW (QL Advancement 
Working Group) to issue the 
first broad-based questionnaire 
on the OL and its users since 
the early years of its develop- 
ment (see pages 25-28). This 
pull-out questionnaire will be 
analysed by QLAW to provide 
a detailed profile of the QL 
community and its future 
needs. An article or articles 
based on the analysis will ap- 
pear in QL World later in the 
year. 

Founder Dr. Sohail Bhatti 
describes the idea behind 
OLAW: “OQLAW is a new in- 
terest group formed to 
encourage the development of 
QL/QDOS related products, 
both software and hardware, 
as a means to the production 
of a new SuperQL. This new 
machine is its main goal, and it 
seeks anyone who would be 
interested in participating. 
This includes not only those 
with hardware and software 
expertise, but also those who 
would wish to purchase such 
a machine. Joining would be a 


clear indication of interest, 
with the expectation that 
QLAW would use the group 
strength to generate a QL- 
compatible machine fit for the 
1990s. By sharing resources, 
OLAW would seek to make 
the task manageable.” 

To join QLAW, there is no 
compulsory subscription, but 
as launch capital is minimal, a 
donation of £10 is requested 
for registration on the mailing 
list. “I havechosenasum which 
| hope will allow such devel- 
opments as — seminars, 
hardware and software design 
as well as pay for mailing,” 
says Dr. Bhatti. Users who are 
interested in joining but can- 
not afford the £10 might like to 
approach Dr. Bhatti with al- 
ternative suggestions. 

A professional statisticianand 
long-standing member of 
Quanta, Dr. Bhatti has gained 
support from some fellow- 
members, members of the 
committee, and also from OL 
designers and suppliers. 
QLAW is however intended 
primarily to co-ordinate the 
requirements of users rather 
than suppliers. 


A new QL Special Interest Group 


“OLAW is intended as a us- 
ers’ group and so will exclude 
all traders from influencing 
OLAW decisions. However, it 
will seek to develop a consen- 
sus amongst all users, so that 
there are common goals and 
standards", writes Dr. Bhatti. 

Ultimately OLAW’s aim is to 
co-ordinate design skills and 
user needs within the OL com- 
munity to develop and extend 

the OL to meet the challenges 
of the 90s. He argues what 
many users believe: that the 
QL and QDOS is an advanced 
system which is under-used. 
Now is the time, he believes, to 
consider what can be achieved 
by pooling the best of our re- 
sources, and spreading the load 
of development. 

Uptodatenews willbe shared 
through the mailing list, and 
designers would be able to call 
on the membership for beta 
testing of new products. A non- 
disclosure agreement would 
ensure security anda fair share 
in the gains for individual de- 
sign work. 

The QLAW questionaire will 
also appear in a substantially 
similar form in Quanta, and 


CGH Services’ QL Technical 
Review, as well as through 
various Overseas user groups. 
The OL World questionnaire 
incorporates a number of 
questions relating to the avail- 
ability and value of QL World 
itself which will not, of course, 
appear on other drafts of the 
questionnaire. The analysed 
data and comments in this sec- 
tion help the magazine for QL 
users to plot its future con- 
tents. 

To join QLAW or obtain fur- 
ther information, write to Dr. 
Sohail Bhatti, 4 Wasdale Av- 
enue, Park View, Blackburn, 
Lancs. BB1 1XD. Please make 
cheques payable to QLAW. 
Stamped self-addressed enve- 
lopes are appreciated with 
enquiries, to keep down run- 
ning costs, 


QLAW and QL World have no 
association other fhan in the pub- 
fication and analysis of the 
OLAW/QL World questionnaire 
appearing on pages 25-28 of tris 
issue, OLA Wis a non proftt mak- 
ing user group wich does not 
claim endorsement from any com- 
mercial organisation. 


Fractal 


poster 


Organised Chaos is a business 
in Manchester which is dedi- 


cated to producing 
high-quality small-poster sized 
fractal images. The sample 
deposited with OL World is an 
A2-sized, glossy poster show- 
ing a Mandelbrot image ona 
purple background, with a 
short history and commentary 
on the Mandlebrot Set at the 
base of the sheet. 

Says OC's Colin Menhinick: 
“The computer generated im- 
ages are as clear as a colour 
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There are no 
marks , castle edges, blurred 
spots or fine lines missing. You 
get the full majesty of the — 
age in hairsbreadth detail.” 

sees the posters as an thes 


P photograph. 


tional resource for Maths and 
Computing departments, and 
the sciences in general. 

Organised Chaos offers its 
posters with a money-back 
satisfaction guarantee. The 
posters cost £9.95 inclusive of 
VAT, plus £1.50 post and pack- 
ing. A block-mounted version, 
designed for schooland college 
use, with a washable surface, 
costs £29.50 inclusive of UK 
carriage and hanging set. The 
poster sent to us arrived in a 
heavy-duty card tube with a 
strong plastic stopper, in per- 
fect condition. 

Orders and enquiries to Or- 
ganised Chaos, 10 Stanton 
Gardens, Manchester M20 
8PT. Tel: 061 228 7356. 


Guide slip 


Our apologies for two mis- 
prints in Part Three of the New 
User Guide. At the bottom of 
page 27, the PAPER command 
should read PAPER#2,4, and 
on page 28 under the AT com- 
mand, the commands in the 
text should read AT#2,4,2 and 
PRINT#2. The short program 
over pp.27 to 28 should finish 
with: 
CLS #2 

Reader Dr. D C Lewis of 
Shrewsbury points out that the 
reference to the window 
number at the bottom of page 
27 should more properly read 
‘channel number’. 


PEN HANNEL 


somebody with the answer, or just sound off 


Open Channel is where you have the 
opportunity to voice your opinions in 
Sinclair QL World. Whether you want to ask 
for help with a technical problem, provide 


about something which bothers you, write 
to: Open Channel, Sinclair OL World, 
116/120 Goswell Road, London EC1V 7QD. 


[ have been a regular daily 
business user of Quill for the 
past five years, and am writing 
this letter as a result of seeing a 
pre-production version of 
Digital Precision’s Perfection 
demonstrated at the London 
Quanta sub-group. 

As someone who is all too 
familiar with the destructive 
quirks of Quill, I would say, 
forget your concerns that noth- 
ing can be as useful and as 
uncomplicated as Quill, and 
put your order in for one now. 

[am pleased to say that thisis 
probably one of the last letters 
I will ever write where there is 


a possibility that the cursor will 
disappear and that in an in- 
stant I will lose a carefully 
worded document. 
Nigel Spencer 
London SW17 


I found Gavin Monk’s LDEF 
command described in June 
1990 very useful, and so was 
disconcerted when on one oc- 
casion it wouldn’t work with 
the later procedures and func- 
tions in a Basic program. On 
re-checking the listing, I no- 
ticed that in lines 53 and 74 
index register A2.W instead of 


A2.L was used. This is alright 
when Basic programs are small, 
but failsif they are larger, because 
thenametableand namelistcome 
higher in the Basic area than the 
program. 

Also, am surprised that af- 
ter line 68 we do not have 
EXT.W D1 and EXT. L D1 to 
allow trouble-free addition of 
D1 to Al atline 92. Afterall, we 
are told that CA. GTSTR cor- 
rupts D1 and, at line 41 that 
seems to be the last place D1 is 
used. At line 68 only D1.8is set, 
so the rest of D1 could be any- 
thing. 


G D Gwilt 
Edinburgh 


Some time back you asked for 
people’s experiences of the 
Minerva rom. Here are some of 
mine. I’ve had three versions 
of Minerva V1.61.1.66and 1.81, 
each one better than its pred- 
ecessor and all of them better 
than the old JS roms. I use my 
machine for word processing, 
using DP’s Editor and Psion 
Quill. lalsorun Borland’s Turbo 
Cunder Conqueror for a college 
course. 

As to what I like about the 
Minnie, 90 per cent of the time 
1 don’t even know it’s there (as 
should be the case with an op- 
erating system). I now no 
longer have to waste valuable 
memory loading third party 
software to speed up graphics 
and math routines, thought I 
do use the excellent Lightning 
rom text extensions. My 
SuperBasic programsrun faster 
{as does the machine gener- 
ally),and whenI makea syntax 
error Minerva shows me the 
point on the line where I made 
the mistake. 

Notonly canluse cursor left / 


right to navigate round a line, 
but Minerva implements 
Home and End keys with an 
ALT LEFT/ALT RIGHT com- 
bination. There are also line 
delete keys. 

My machine starts up faster 
(I have a full Trump Card), 
there is no more waiting ages 
for the ram test. Minerva does 
a more thorough test of ram, 
and if I have a duff chip, 
Minerva will tell me, so I can 
now be more confident of my 
QL hardware. If [runa QView 
program, I can even get a 
schematic diagram of where 
an offending ram chip is. 

1 like the idea of Qdos being 
back under development. It is 
nice to have an operating sys- 
tem that has customer technical 
support again. Qdos was never 
‘finished’, and anyone who 
wants to stop its development 
atthe old MGs obviously hasnt 
grasped Sinclair’s original 
dream for the machine. 
Minerva isn’t perfect, but it is 
getting there. 

Dominic Brown 
West Kingsdown 
Sevenoaks 


I have found a bug in 
Superbasic I have not seen de- 
tailed before. It concerns the 
comparison of strings. Some 
characters are considered equal 
by the interpreter, which are 
obviously not. I stumbled on 
this while writing a guarded 
input routine; the character Ois 
effectively the same as the cur- 
sor up key. The only way to 
distinguish is to compare 
CODESs. I have since found a 
total of 64 cases (see enclosed 
printout). There is an interest- 
ing effect: for example, A is 
equal to CHR$ 225, and a is 
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ene > quel 


equal also to CHR$ 225 but A is 
not equal to a (using == com- 
pletes this). 

A few months ago, Mike 
Lloyd gave a function for 
signum: RETurn 1-(x<=0)- 
<x<0). This does have an 
elegant simplicity, however, 
the alternative, RET <x>0>- 
<x<0> works just as well. 

Caleb Leeke 
Huntingdon 
Cambs 


For some time I have been us- 
ing a BT Merlin Tonto compu- 
ter. | understand that it is a 
derivative of the Sinclair QL 
and was on the market in the 


early 1980s. 
[use it both for its word proc- 
essor (Quill) and _ its 


spreadsheet (Abacus), as well 
as the telephone side, and find 
it an invaluable office tool. 
Ihave been reading QL World 
for six months now and find it 
very interesting, but wonder 
how relevant the articles are to 
my Tontoin the long run. What 
do other Tonto users (if there 
are any) feel? 
LM Westall 
Yarnton 
Oxford 


I have vast amounts of data 
created using Quill, Abacus and 
Easel. Ihave to be able to access 
this data using any of a selec- 
tion of programs on the PC, 
including the Psion PC4 pack- 
age, which looks a lot like the 
QL version. 

Ihave PC Conqueror and its 
disk conversion facility, butam 
unable to access the files cor- 
rectly once they are on PC 
format disks. What do I do to 
get my files into a readable for- 
mat? 

CA Bland 
Green Street Green 
Orpington 


Editor's comment: First, you 
should ask Digital Precision’s ad- 
vice. Always talk to the publisher 
first. Also, somebody experienced in 
using DiscOver may beable toadvise. 
Transferring data between one oper- 
ating system/utility combinationand 
another totally different combina- 
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tion can be a knotty problem even 
with bare Ascii files. 


Here is a little problem that I 
would like some help with; I 
have been using an IBM com- 
patible (an M31PC SMC PC- 
386SXP) for the past 18 months 
(along with my trusty QL). The 
IBM clone has both 3.5in and 
5.25in floppy drives, as well as 
a 40MB hard disk, and runs 
DR-DOS using all the function 
keys from F1 to F12. 

I willshortly be losing the use 
of the M31PC - how can I 
transfer all my software and 
files to use on my QL? This isa 
considerable amount. What 
would I need to purchase to 
run all this on my QL? And 
what would it cost? Iam using 
Ability Plus from Migent, Sage 
Accountant Plus, Logitech Fi- 
nesse DTP and some other 
simple programs. Will I be able 
to use these? My main soft- 
ware packages are stored on 
hard disk and I use this to run 
each program using the CD/ 
command. But I have very lit- 
tle actually stored on the hard 
disk. 

Please bear in mind that lam 
not totally computer literate 
and just get by with simple 
instructions. 

Just to give you all a chuckle 
Ihave yet toadd disk drives to 
my QL and am, like a few oth- 
ers, still running the basic ma- 
chine with mdvs. I know that I 
will have to upgrade, but is it 
going to be financially viable? 

John Crompton 
Oakehampton 
Devon 


Editor’s comment: the software 
exists to port material from a PC- 
compatible to a QL system, and 
also emulate the MS-DOS envi- 
ronment ona QL. Your first move 
should be to talk to Digital Preci- 
sion, who publish the main PC 
emulation program Conqueror. 

You will certainly have to ex- 
pand your memory if you are to 
run a DTP package on a QL. 
Miracle Systems market a disk 
drive interface and memory ex- 
pansion board,and EEC Ltd. may 
also be able to advise. Beware of 
moving straight to a hard disk if 
you are not very confident on your 
computers. 


As for which programs you can 
use, again this is something you 
will have to talk over with the 
publishers of the emulator, because 
it is on that that you will depend. 

As to whether it is financially 
viable, that will depend on cost of 
setting up your own PC system 
versus cost of expanding your QL. 
There are two points you haven't 
covered in your letter; one is how 
much you currently use your QL 
and what investment you have 
already made in it, in software, 
and the other is: are you the owner 
of the PC-compatible programs 
you list, or are you relying on 
copying them from your place of 
work? If you were considering the 
latter and the legal aspects of this 
had not occurred to you, remem- 
ber that you would be in breach of 
copyright, and also that your pro- 
grams would then be unable to 
claim upgrades or seek assistance 
from the publishers. 

If you have to rebuild your soft- 
ware collection rather than sim- 
ply porting the data, this will make 
the sums look rather different. 
There is a great deal of good soft- 
ware for the QL, including ac- 
counts and DTP. 


Am [alone among your read- 
ers, oris there another Agenda/ 
QL user out there? The Agenda 
is an organiser with several 
extra features compared to 
those mentioned by David 
Drysdale last autumn — touch 
typing entry system, and the 
most remarkable Finding and 
Printing system that I have yet 
to find. But when I came to 
trying to store backup files on 
the 3.5in disks of my Sandy- 
expanded QLUM rom) using 
serial interconnection , I found 
that I need some routines to 
negate print instructions when 
sending "organiser to QL", but 
could send anything the other 
way. 

I use Editor Special Edition, 
from Digital Precision. The 
Agenda has a very useful sys- 
tem of sub-files, one for each 
letter of the alphabet within 
which searches can be made 
very quickly; addresses under 
A, telephone numbers under T 
are obvious choices. My ad- 
dress list transferred toQL (with 
afew non-print characters) and 
my only worry was a lack of 
indication when transfer was 
complete. The same file sent 


back to Agenda arrives as a 
series of lines with nothing to 
show where one address ends 
and the next one starts. 

It is a good to be able to write 
letters on trains and buses, but 
the ability to edit on a monitor 
before printing and store on 
disk would be a big asset. [ 
write in the hope that someone 
else has made some progress 
alone the same path: my 24-pin 
D connector, OL Ser and 25- 
pin D connector numbers are 
as follows: 


1,2,3,5,7,20 
GND,23415 
-, TX, RX,CTS, Sig, GND, DTR 


Alec Wilson 
Colden Common 
Winchester 


Cattle 


I bought a QL about five years 
ago with the idea of using it for 
my work, which is looking af- 
ter 150 cows. The idea was to 
use it for breeding, milk 
records, health records and the 
pedigree records of each cow. 
Because the QL User Guide is 
so large and it takes time to 
learn everything about the QL, 
Ihave never got as far as using 
it for my working records. 
Now the National Milk 
Records have come up with 
Herdfile software. They sup- 
ply a single disk every month 
with all the details I require up 
to date. The problem is that the 
disks, which are available in 
3.5in and 5.25in, are only suit- 
able for IBM or IBM compat- 
ible computers. My other 
question is, can a disk drive of 
any make be fitted to my QL to 
enable me to use this service? 


CA Trim 
Alresford 
Hants 


Editor’s comment: Software de- 
signed for IBM personal comput- 
ers and their compatibles runs 
under the MS-DOS operating 
system, not QDOS as used by the 
QL. To run programs under MS- 
DOS, you would need an MS- 
DOS emulator. You should talk to 
Digital Precision about their 
program PC Conquest. Not all 
MS-DOS software will run un- 
der a specific emulator, so they 
may need to see a test disk. 


DIGITISER 


QL HARDWARE REVIEW 


CQV1 REAL TIME DIGITISER 


he new real time video digitiser 

from CL Systems arrived in a 

substantial parcel a couple of 

weeks ago, and television has not 
been the same since. 

Although they do a similar job, video 
digitisers and digital scanners are very 
different pieces of equipment. A digital 
scanner is an optical device which is 
moved across a printed image in order to 
copy theimageintoacomputer’s memory. 
Jurgen Falkenberg’s scanner is attached 
to a standard dot matrix printer head in 
order to provide motive power. A real- 
time video digitiser, on the other hand, 
also converts images into a digital format, 
but its image source is a video recorder or 
a video camera. Where a digital scanner 
can take ten minutes to scan its image, a 
video scanner has to perform the same 
task in a fiftieth of a second in order to 
capture a video frame. The results can be 
astonishing. 


Scanning, 


Video scanning has a number of practi- 
cal uses. The computer can be pro- 
grammed to capture an image every few 
seconds or minutes in order to produce a 
time-elapse sequence of images. Point 
your camcorder towards a cloudy sky 
(nowhere near the sun, of course) and the 
OL can be programmed to capture and 
store an image every five minutes for 
almost two hours. Replay the images and 
you will see the same cloudscape unfold 
in a few seconds. 

Alternatively, the video digitiser can be 
used to print out selected images from a 
camcorder sequence to assist in editing, 
or to provide a printed graphic record of 
what is on a video cassette. 

Desk top publishers are going to find an 
instant use for video digitising because it 
can capture video and tv screens ina form 
suitable for importing into documents. 
Unlike the digital scanner’s output, the 
images produced by the video digitiser 
need very little ‘cleaning up’. Of course, if 
you use an art program like Eye-Q you 
can use tv screen images sampled by the 
digitiser as the basis for your own original 
artwork. 

Firstly, though, the practicalities. The 
video digitiser is a box 18cm by 11cm by 
5.5cm which fits into the rom expansion 
slot at the rear left of the OL, completely 
dwarfing the displaced Super Toolkit II 


12 


Mike Lloyd meets a machine that takes pictures 
from the tv, and keeps them. 


rom which normally lives there on my 
system. Although it is a large box it feels 
extremely light. In order for it to be stable 
it must sit on the same surface as the 
computer, so the QL’s ridiculous plastic 
feet will have to be removed. If the QL is 
sitting on a highly polished surface, a bit 
of Blu-tak under both the computer and 
the digitiser will ensure that they remain 
married together throughout a session. 

A major logistical exercise, in our house 
at least, was the positioning of the OL 
withina cable-length of the video recorder. 
If you are still using the family tv set for 
your computing this is unlikely to be a 
problem, butit’s a little more complicated 
for those of us long since banished to the 
spare bedroom to practice our black arts. 
Following successful negotiations, the QL, 
disk drive, keyboard extension and a six- 
way power distribution block arrived in 
the front room. The printer stayed up- 
stairs because the COV1’s software al- 
lows images to be saved to disk and 
printed later. 

The sequence of events at the start of a 
digitising session is critical. Firstly, have 
everything turned off while the cable con- 
nections are made. Set up the QL system 
as you would normally and add the video 
digitiser to the rom port. Next, connect 
the digitiser to the video source (a camera 


or a video recorder) with a standard 
phono-plug cable such as those found on 
stereo systems and usually with 
camcorder systems. 

After making sure that all the connec- 
tions are sound, turn on the video source 
before booting up the QL. This ensures 
that no damage is done by stray electrical 
surges and imbalances between the vari- 
ous circuits. If the QL does not boot in the 
normal way, remove the power as quickly 
as you can. Incidentally, the instructions 
provided with the review copy of the 


machine tell you to turn the video re- } 
corder on first some two paragraphs after | 


it tells you to turn the QL on. 


Samples 


Two boot files are included on the disk 


accompanying the digitiser, one for floppy | 


disk systems and another for microdrive 
users, Other files contain a small amount 
of runtime extensions and the main ex- 
ecutable file. A couple of sample screens 
are thrown in for good measure. 

The defaultsystem boot file simply loads 
the extension codes, leaving you to launch 
the executable program in your own time. 
This is sensible because the digitiser is 
fully multi-tasking, allowing you, for in- 
stance, to havea real-time tv image show- 


QL Video Digitizer 
Main Commands 


F1 Draw Menu 
ma F2 Save image 
§ F3 Load Image 
F4 Sample Input 
F5 Clear Screen 


D Select Display 
§ Auto/Manual 

ma = sample mode 
N Negative Image 
| Inverted Image 
P Print Dump 


_SHIFT +_ 
F2 Store Image 
F3 Recalt Imago 


CTRL + 
F3 Merge Images 


CTRL/SHIFT + 
F3 Merge Images 
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ing in the top corner of a screen otherwise 
devoted to a Quill session. 

When the program has been loaded the 
main menu appears below a digitised 
picture of a sports car. The controls are 
very straightforward and can be memo- 
rised within a few minutes of using the 
system. The function keys are used to 
display the menu, control disk/micro- 
drive access, start the real-time sampling 
and clear the screen. Throughout the re- 
view period the software behaved fault- 
lessly, like the construction of the device 
itself, gave the impression that the video 
digitiser is a very well thought out pe- 
ripheral produced by a company with 
high standards of workmanship. 


Capturing 


Pressing F4 starts the image capturing 
process in manual mode. Every time the 
space bar is pressed a video image ap- 
pears on the screen. To move to the real- 
time sampling mode the ‘S’ key is pressed. 
With the full OL screen being used to 
display the images a new frame is pro- 
duced every two and a half seconds. The 
clarity of the image is amazing, especially 
as the QL has only eight colours and a 
256x256 pixel resolution at its disposal. 

It is probable that at the beginning of 
each sampling session the digitiser’s con- 
trast will need adjusting. This is done by 
turning the only control the digitiser 
needs, a small red knob mounted at the 
back of the box. At one extreme, the QL 
display is all whites, cyans and yellows 
while at the other the picture is black, red 
and blue. Optimum adjustment is easy to 
achieve. This facility contrasts with the 
post-scanning adjustment of the colour 
balance available on Falkenberg’s digital 
scanner. 

Three screen modes can be selected 
whether you are in ‘step-mode’ or are 
sampling ‘real-time’. Pressing ‘D’ toggles 
between a full-screen display, a quarter- 
screen display and four quarter-screens 
refreshed sequentially. The quarter-screen 
display in step-mode proved extremely 
interesting during action sequences in 
films. Quarter-screens are refreshed so 
quickly that the refresh rate does not be- 
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come obvious except during camera-pan- 
ning sequences. 

The clarity of the images matched with 
the sometimes bizarre colouration turns 
even the dullest film into a new art-form. 
Printing out a picture on a dot matrix 
printer, however, turns the colours into a 
more acceptable grey scale. The print 
quality provided by the in-built print 
dump routine was quite sufficient for 
normal use, although I found Sidewinder 
was invaluable for cropping and re-siz- 
ing the images. 


Video tricks 


Some additional video tricks have been 
added to the digitiser package. Screens 
can be stored in ram by pressing Shift-F2. 
With expansion fitted, more than a dozen 
full-screen images can be saved. Other 
keypresses allow you to recall the pic- 
tures, invert them, turn them into ‘nega- 
tives’ and merge them into each other. 
Their value is perhaps open to question, 


DIGITISER 


Some sample screens 
included by CVS with the 
video digitiser package. 


but the code to implement them is so 
simple that they do not add much to the 
bulk of the controlling program. For more 
involved manipulation of the images Eye- 
Q permits greater expression. 

The CQV1 video digitiser proved easy 
to live with, once the computer and the 
video had been moved to within sight of 
each other. The menu selections were 
sensible and the more commonly-used 
ones were readily remembered. The pro- 
gram operated flawlessly and produced 
no clashes with other programs tested. 
The digitiser is available from CL Systems 
(See also their adsin the back of QL World) 
for £123.000 


INFORMATION 


Product: COV1 real-time video 
digitiser. 

Supplier: CL Systems, 403 Chapter 
Road, Dollis Hill, London NW2 5NG. 
Tel: 081 459 1351. 

Price: £123, inclusive, state mdv or 
flp. 
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iracle Systems’ new Gold Card 

provided all the buzz at the 

April27 Leyland computer show 

organised at Runshaw College, 
Leyland, Lancs, by Sector Software's 
David Batty. 

As some enthusiasts prattled on about 
the Gold Card heralding the new golden 
age of the QL, others wondered just what 
they would be getting for £375, which, 
let's face it, is almost as much as some 
people paid for the computer in the first 
place. 

The Gold Card, it seems, is a replace- 
ment for all existing ram-plus-disk inter- 
faces and other QL expansions, and a 
trade-in allowance will be made against, 
them varying between £25 and £150. 

The new expansion will speed up the QL 
by as much as four times and give almost 
two Megabytes of ram. It will also accept 
new disc drives with a total capacity of up 
to 3.2 megabytes. In addition the expan- 
sion houses a battery-backed clock. 

A battery-backed clock is also a feature 
of the new £65 Minerva Mk II rom, intro- 
duced at the show by Tony Firshman. 
This clock, on its own chip with 256 bytes 
of ram, has the advantage of being com- 
pletely crashproof. The new Minerva MKIl 
has a Philips 12C interface which is able 
to drive a whole range of chips. It also has 
a switching facility as part of an analogue/ 
digital Philips chip interfacing to the 12C 
bus. This facility was used, at the show, to 

| control a robot playing the old Chinese 
game of ‘Towers of Hanoi’. The battery 
ram can also be used to autoboot QLs, via 
the network, without any drives being fit- 
ted. 

Another new product was Digital Preci- 
sion’s word processor Perfection which 
Freddy Vachha says ‘will knock your socks 
off’. How many programs Freddy actually 
sold at the show is anybody’s guess, as 
the demo was so fast and furious that it 
was difficult to get even the tiniest order in 
edgeways! Plenty of leaflets were being 
picked up, however, and there is no doubt 
that orders will come rolling in by post 
once the many features of this idiot-proof 
word processor have been digested. 


Freddy Vaccha of Digital Precision. 
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David Drysdale 
visits the show 

at Leyland, and 
meets the newest 
and best. 


This after-the-show sales boostis par for 
the course on these occasions according 


to Tony Phipps, Business Development | 


Manager of EEC Ltd., whose stand had 
leaflets offering an Epson 3.5in 720KB 
floppy disk drive for just £38 including 
VAT. A Sinclair 14in CGA colour monitor 
was also on special offer at £120 and 
back-up JM version QLs for only £85. 
Tony says he is highly optimistic about the 
future of the QL. His company, he says, 
will continue to support it to the full. 

The show's organiser, David Batty of 
Sector Software, was finding plenty of 
interest for his £14 crossword-solving 
program Wordsmith which could find 
words and solve anagrams at lightning 
speed. He demonstrated by keying the 
letters ‘ology’ and thirteen words contain- 
ing it came up in less than one and a half 
seconds. His STD-/ndex program was also 
selling well. This stand-alone database of 
over 6000 UK dialling codes was devel- 
oped to enable users to find a place loca- 
tion from a telephone number. People 
buying goods advertised in magazines 


A 


Tony Firsham demonstrates the new 
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SOW REPORT 


Tony Phipps of EEC Ltd., and stock. 


such as Exchange and Mart would find 
this program useful as they would know 
how far away the vendor was and whether 
the bargain was worth picking up. With 
director enquiries costing 40p a time this 
program, at £14. would pay for itself in the 
first 35 queries. 


QL SUPERTOOL KIT II by Tony Tebby 


Over 118 Commands:- Full Screen Editor, Key Define 
Print Using, Last Line Recall, Altkey, Job Control, File 
Handling, Default Directories, Extended Network, 

16k Epram Cartridge Version .. ... @£23.50d 
Configurable Version an Micradnve ............. @t23,50d 


MIRACLE SYSTEMS PRODUCTS 


OK Disc Intertace (Inc Tool Kit I) ................ @E99.64b 
OL Centronies Printer Interface @P29 61d 
QL Expanderam 512K Thrucard ... @E99.64b 


QL HARDWARE 


Single 3.5" Disc Drive & (Own PSU}, » @E105.75a 
Dual 3.5" Disc Drive & (Own PSU}. 
3.5° DS‘DD Discs 10 off .. . 
QL Keyboard Membrane... 
Care Eprom Cartridges each : wives @EGB.1 #0 
ULA CHip 2X8301 .......... @f15.98c 


SOFTWARE 8&7 (State MDV or Disc) 


TEXT8?7V3.00 (Requires Min 256k} .............@£60.00d 


FOUNTED 839 .......... we @E15.00€ 
FOUNTEXT 88 oo... arises aan ADEZOOOS 
TEXT 87'/FOUNTED 89;FOUNTEXT 88 @94 94h 


2488 PRINTER DRIVER................... . @£15.00¢ 
Upgrade to Taxt 87 V.3,00, Return ald copy together with 
, pass cash @E25 00d 


MONITORS (Price including lead) 


Philips CM8833 Colour Med-Fes ............... @£258.50a 
Philips BM7502 Green Hi-Res 2... £99.64a 


HOW TO ORDER: 


By Post. Enclase your Cheque'PO made payable to CARE 
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Miracle Systems’ new Gold Card. 


Other inexpensive programs which 
seemed to be selling well were QL Ge- 
nealogist and Super Disc Labeller on the 
Dilwyn Jones Computing stand. At£19.50 
Genealogist was his best selling mail or- 
der program, said Dilwyn, but a lot of 
interest was now being shown in Super 


OPAC Il Main menu windows adjust automatically to size 
Files. directory, view, print, delete, backup. jobs, pick 
Rjob, sort, channels, things exec, wake, buttons, Hotkey, 
Hotjobs. Fully multitasking, allows many programs to run 
at once, Requires mn of 256k expanded memory 

@£ 


Upgrade QRAM to QPAC II return master 


PLEASE SEND SAE FOR 
FURTHER INFORMATION 


TONY TEBBY SOFTWARE (QJUMP) 


QLFP (Micro;P disk intertace upgrade} @£15.51d 
QTYP Type/Spell Checker » @£30,55d 
QPAC 1-Desk top accessories, calander, alarm. calcula 
tor, typewriter, digital clack sysmon .... ........ @£22.56d 


ZITASOFT SOFTWARE by Steve Jones 


LOCKSMITHE copies M/DRIVE - M‘DRIVE @£14.10c 
4MATTER + LOCKSMITHE copies M‘DRIVE - DISC 

Sievert Si viaisanseiie se schi ssa suecees ..- @£23.50¢ 
SIDEWINDER - High resolution printer driver prints full 
screens or parts of screens from postage stamp size to 
arge banners, Prints sideways, invert, scale. mirror. text 
INSERM setorcts dacerencizxorecnaoce eh » @E20.21c 
SIDEWINDER PLUS - (for expanded QL's) includes all 
the features of above, PLUS multiple label printing. desk- 
top publishing files anc printer driver for 24" pin plusprinters 


MD} .. scieminnsiets 
Upgrade to Sidewinder Plus ....... 


Electronics or use ACCESS VISA. Allow 7 days lor delivery 


Disk Labeller which not only produced 
neat labels in various type sizes but also 
printed disc sleeve inserts and Directory 
page printouts. The cost of this program 
was only £10. 

A tightly packed and up-to-date 16 page 
list of programs including games, utilities 
and fractal and mathematical recreation 
programs was available on the CGH 
Services stand. One program for sale 
soonis Cribbage and Bridge Scorer which 
will allow the well-known game of crib to 
be played on screen. 

Club secretary Ron Dunnett and Dennis 
Briggs were representing Quanta at the 
show. For Ronitmeant an exhausting 500 
mile round trip. The local Quanta Lancs 
Area Sub-Group QLAS were there too 
displaying their newly minted tin badges 
bearing the QLAS logo. Their stand fea- 
tured a video camera and Spem digitiser, 
which they were using to make portraits of 
the visitors. 

Although it was an all-formats show, the 
QL sector was dominant. Other exhibitors 
seemed pleased, however. One non-QL 
dealer, Mr S A Raja of Scan International, 
told me he had sold over 3000 3.5 floppy 
disks during the day. on top of printer and 
computer sales. I left the last word to show 
visitor Richard Cooke of Wigan. Did he 
intend to buy anything at the show? “Of 
course”, he replied. “The new Gold Card, 
what else!” 


Switch mode power supply, QL runs cool, 
stops, lock ups (due to voltage drop). Helps 
filter noise out. Simple to fit (no soldering) 
£25.85c 


MULTI COLOURED PRINTER 
RIBBONS 


Huge range of coloured printer ribb Hable in RED 
GREEN. BLUE. BROWN, PURPLE, YELLOW, ORANGE, 
MAGENTA, SILVER and GOLD 

Prices fram as law as £3.00. Please phone for price and 
delivery. 


READY MADE LEADS 


RGB QL TO PHONG 

AGB 8:6 PIN scwcmmnernsnecnatne 
RGB 8.7 PIN HITACHI... 

RGB 8-7 PIN FERGUSON ..... 

RGB 8 PIN TO SCAAT ....... 
SWAY PCC TO 25WAY 'D 


24 Hour Order Line 0923 894064 
OPEN 
Sam-5pm Mon-Thu 
Sam-4pm Fri 


CARE ELECTRONICS 


DEPT QL, 15 HOLLAND GDNS 
GARSTON, WATFORD, 
HERTS, WD2 6JN. 

Tel: 0923-894064 
Fax: 0923-894064 


Please add carriage 
a=£11.75 b=£3,76 
c=No charge q=22.35 


TAN 0 UE 


very month or so, there is some 

software and/or hardware devel- 

opment (however minor it may 

seem) onthe QL scene. The Gold 
Card has been further developed, and 
has been demonstrated with both 12 and 
16 MHz cpu chips. It now looks as though 
the 16 MHz version will be available right 
from the start, and the small difference in 
price suggests there is little pointin buying 
the slower version. 

Considerable improvement has been 
shown in performance of various pro- 
grams, when run under the Gold Card. 
Quill clearly runs much faster. Perfection 
is even faster than before, but it was so 
fast anyway that the improvement is in 
fractions of seconds. Even Lightning has 
more effect. Professional Publisher is a 
program which shows improvements in 
some areas but notin others; routines that 
are written to run in a set time will still do 
so, but menus appear much faster. The 
relative slowness of menu activity irked 
meas much as anything it should be nicer 
to use now. 

Perfection continues to change its face, 
although the ‘works’ have been mostly 
finished for some time. The user interface 
is reported to be much improved and a 
definitive version of the program should 
be available for checking any day now. 
There is no doubt that the combination of 
the Gold Card, high-density disk drives, 
and Perfection will transform the QL for 
word processing work. 

QFile reports that Discopy has reached 
version 2.07, and the manualis now laser- 
printed. The latest revision was necessi- 
tated by a problem when using the pro- 
gram with the Atari ST QL Emulator; op- 
eration on this combination is now correct. 
The program will be reviewed shortly. MS- 
QLink is at version 1.6 and has a new 
manual, also laser-printed. The new ver- 
sion provides two pages of Help when F1 
or F3 are pressed. 

Hearing about computing in another 
country can be interesting. A guest in our 
house at the time of writing is a young man 
from East Germany, who is a computer 
enthusiast. From what one reads in the 
newspapers, it would be reasonable to 
expect him to have an ancient Spectrum, 
which cost a lot of money, and be using 
primitive programs, written by himself. 
Not so. He has a fast PC (25 MHz), with 
two hard disk drives, and plenty of up-to- 
the-minute software. 


Bryan Davies 
considers ‘a new 
phase in the QL's 
life’. 


The only thing that is what | had ex- 
pected is that almost all the software is 
pirated. He has been comparing prices 
here with those at home, and tells me 
everything is much more expensive here. 
So far, the only thing (of any sort) that he 
has found cheaper in the UK is a postage 
stamp! Maybe this situation will change, 
when the effects of the initial, artificial 
exchange rate between East and West 
German currencies wears off. A local QL 
friend demonstrated Qpoac to our guest 
(who uses Microsoft Windows on his PC), 
and he was duly impressed that a compu- 
ter which he had never before heard of 
had something similar to what he used; he 
had not been aware that there was a multi- 
tasking 8-bit computer. 

This brought up the inevitable discus- 
sion on text only —as opposed to graphics 
— interfaces, and | found myself in the 
minority (as usual). There is a lot in com- 
mon between QPac and Windows; both 
give avery attractive screen presentation, 
and require a mouse, to be used sensibly. 
On the surface, both programs allow the 
user to do almost anything, simply by 
playing tunes on mouse buttons. Coinci- 
dentally, | had just been trying to get two 
Windows demonstration programs work- 
ing, SO was ready for some discussion (to 
putit politely) on the subject of text-versus- 
graphics interfaces. 


Space required 


Although there are similarities between 
the QL and PC products, there are some 
big differences, the most obvious one at 
first being the space required to house 
whatare, after all, only utilities. Would you 
believe that the demonstration Windows 
program requires about 5 MB of hard disk 
space? Since most of the program func- 
tions in the demonstration version are 
disabled, one could expect the ‘real thing’ 
to need a couple of other computers net- 
worked-in to get it running. Actually, it's 
not that bad, but you need about 4-plus 
MB of disk space for the program alone 


L 


(without demonstration files and functions 
| would not use). At this point, you can 
start looking for space to house the pro- 
grams you actually work with. It's a bit like 
saying that you, as a Quill user, need 50- 
100 KB to do your work, but another 500 
KB is needed to connect you to Quill. 

We are at the start of what may be anew 
phase of the QL’s life, with the advent of 
the Miracle Gold Card, and the 2MB of 
memory it provides for us. For us, that 2 
MB will allow the running of several, big 
programs, as well as something like QPac. 
The poor PC user, trying to do a similar 
thing, wouldn't even get the utility program 
working reasonably, let alone have any 
applications programs working as well. 
No, I’m not confusing disk storage with 
memory. Windows also requires large 
amounts of memory to work properly. My | 
German friend has a'‘swap file’ of 8 MB set 
up, so that Windows can handle the 
switching from one program to another, 
as well as its housekeeping functions. 
Even so, one of my own reasons for not 
using QPac is that it uses more memory 
than | can spare — on an 896 KB system. 
It is to be hoped that any programmer | 
developing utilities for the QL in the future 
does not follow the PC route, now that 
there is 2 MB available, and write utilities 
that take up more space than the programs 
we want to use. 

That’s one point of view. The other main 
one appears to be that the utility program 
is the most important thing, and is what 
computing is all about. Thatis, a computer 
should not be for doing work on, but for 
playing with. Fortunately, there's enough 
choice of software for the QL to suit both 
types of user fairly well. It does seem to 
me though that we are short of some good 
utility functions, regardless of which user- 
category we fit into. None of the house- 
keeping programs | have seen are suffi- 
ciently convenient to use, or flexible 
enough, to meet my needs. It was a pleas- 
ant surprise to find that the WinBack hard 
disk backup program is easy to under- 
stand and use, and does the job quite well, 
without forcing the user to jump through a 
hoop by involving him/her in a complex 
interface. No need fora mouse, no masses 
of keypresses, no massive memory de- 
mands, asimple and clear book of instruc- 
tions; what could be wrong with it? It does 
have some limitations, but they are not 
that great, and later versions should 
overcome them. The program writer's 
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name was not previously known to me, 
which makes it even better that the pro- 
gram is worth having. It is desirable to 
have some new programmers on the 
scene, to fill the gaps left by those who 
have gone other ways in recent years. 

You don't see much mention of the Z88 
computer in these pages, which is rather 
a pity, as itis a very useful little computer, 
and it is one of Clive Sinclair's brain- 
children also. Itis usual to see at least one 
stand of Z88 supporters at the All Formats 
computer fairs, and there are quite a few 
programmers beavering away to produce 
all the little goodies needed for the Z88. 
Being aportable machine, it needs links to 
other types of computer, and it is well 
provided for in this respect. 

There is a good link program to the QL, 
and another to the PC. A good example of 
the usefulness of the Z88 was the job a QL 
using friend did recently. He wrote areport 
on (one of) his 288 while on-location in 
Brazil, and then brought the report back 
here stored in the machine. We used alink 
program to transfer the text file to a PC, 
and aformat-conversion routine (Supplied 
with the conversion program) to put the 
text into suitable form for loading into the 
WordStar word processing program, ona 
PC. Adisk was then sent back to Brazil for 
incorporation into a larger document, be- 
ing prepared on a PC. 

The same process can be used to trans- 
fer text files to QL Quill, text87 or Perfec- 
tion, although there is then no need for the 
rather odd conversions required with 
WordStar. The Pipe Dream text format 
from the Z88 can be used without con- 
version, but it is then necessary to make 
use of the Search and Replace facility 
within the receiving WP program to get rid 
of some unwanted characters. 

An odd point to note from Kaga-Taxan 
users who have bought a laser printer is 
that itis preferable to use the FX-80 driver 
of test®’ rather than the Canon one, when 
printing on the laser in its FX-80 emulation 
mode. Some errors in alignment apparent 


in the samples included with a recent 
article appear to have been due to using 
the Canon driver, which has some func- 
tions which are not standard to the FX-80. 
The sample given here was done with the 
GQ-500 laser driver, to show how well 
proportional spacing and justification is 
handled. 

In the March issue, Edward Jones en- 
quired about adding a second hard disk 
drive to his Thor. He mentioned Rodime 
as a possible supplier, since the original 
Thor drives came from them, but that 
company does not seem a suitable one to 
contact for a single drive now, partly be- 
cause of the continuing financial problems 


Readers Letters 


the company has but mainly because it 
deals with OEMs (original equipment 
manufacturers) and its units are not usu- 
ally seen for sale to the general public. 

The Thor used an SCSI interface, allow- 
ing several devices (of different types) to 
be chained together. You can buy SCSI 
drives from several suppliers who adver- 
tise in PC magazines, but there might be 
some risk of incompatibility, depending 
upon the degree of faithfulness with which 
CST/Rodime and current drive suppliers 
followed the SCSI specification. Another 
potential problem area is the use of termi- 
nation packs on drives; presumably, the 
Thor requires packs on some drives in the 
chain, but not on others. SCSI drives tend 
to cost more than standard, MFM/RLL, 
drives. 

We advise users to buy products with 
credit cards because there is a reason- 
able chance of getting a refund from the 
card company if ordered goods do not 
turn up or are defective. You do need to 
make a claim against the card company 
within a fairly short period of time; don't 
leave it six months or more. What prompts 
the reminder now is another complaint 
about non-delivery of akeyboard, ordered 
from Keyboard Products. The delay for 


LASER PRINT SAMPLE FROM TEXT®” 


This text was written using fext*? and printed with the driver for the Epson 
GQ-5000 laser printer. It is left- and right-justitied, and the printer fount is the scaleable 
Epson Times, in 12-point size. The range of sizes available is 6-72 points. At small point- 
sizes, it may be preferable to use the Epson Helvetica, which is sans-serif -- no "tops and 
tails" on the character-ends -- and is also scaleable. The lack of embellishments on the 
characters improves readability, although the impression given may not be as "professional" 
as with Times. The caption below is in 12-point Helvetica Bold Underlined. You can also use 
the other resident fixcd-height founts -- Prestige, Courier, Modetn and EDP. 
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David McCullagh had been seven months 
at the time he wrote to us (March this 
year). He is one of several people to make 
similar complaints. This supplier has so 
far failed to respond to requests for infor- 
mation on four other orders (but two of the 
purchasers have reported finally receiv- | 
ing keyboards). 

Michael Jackson is one of the users 
who finally got a working keyboard from 
Keyboard Products. He reports that the 
first one received appeared to be ‘a com- 
plete dud’, but the current one works well, 
There have been some problems, suchas 
unexplained system crashes. The crash 
problem may have been solved by the use 
of an anti-static mat under the new key- 
board. The interface which has to be in- 
stalled inside the QL is apparently suffi- 
ciently large to cause conflict with other 
add-ons, such as Minerva. The alterna- 
tive keyboard interface, supplied by 
Jurgen Falkenberg (reviewed by Mike 
Lloyd a few months ago, and available 
from EEC Ltd) leaves more space for 
other interfaces to be fitted. Falkenberg is 
the supplier of the scanner which attaches 
to a printer; this also was reviewed fa- 
vourably by Mike Lloyd, and is available 
from TK Computerware. 

Anthony Magnus from the Balearic Is- 
lands is yet another reader to report diffi- 
culty obtaining a PC keyboard and inter- 
face from Keyboard Products. His order 
was placed in mid-September last year, 
he sent a reminder in early February this 
year, and he was still waiting when he 
wrote another in late March. 

Jackson brought up the subject of the 
KBL 128 computer box, also supplied by 
Keyboard Products. Such a box is a good 
idea, but this particular one is too small to | 
accommodate a typical collection of sys- 
tem devices, such as the QL plus a couple 
of floppy drives, maybe a hard disk drive, 
disk/memory interface. No doubt larger 
boxes can be obtained, but not in the form 
of kits made up specifically for the QL 
user. If you go to Quanta group meetings, 
you will see all manner of assemblies of 
QL’s into boxes, some being quite neat 
and others rather messy, but the average 
user most likely has neither time, ability, 
nor inclination to do a fully DIY job like this. 
There is a small market area here for an 
enterprising one-man company to make 
some money. 

Returning the David McCullagh (who 
must keep a Thor running permanently for 
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writing letters to QL World), he has been 
contacted by Jacques Flury, who was kind 
enough to supply him with both a monitor 
cable and a set of Argos 6.34 ROM chips 
for the Thor XVI, and is going to supply 
connection details for using the Miracle 
printer interface with the Thor. McCullagh 
has been advised not to expect any re- 
sponse from Thor International. To be able 
to add a hard disk to the Thor XVI, special 
chips are said to be needed; it might be 
worth having these chips manufactured 
and the Swiss supplier COWO (see ad- 
dress below) has suggested that it could do 
the job if they had about 20 customers for 
their 0.5-2.0 MB ram expansion units. They 
can also supply different versions of Argos, 
at about SFr. 100 each. 

Back to the Serial 8056 printer again; R 
Thompson asks if anyone knows where to 
obtain continuous paper for this printer. 
We have been this route several times 
before, but | don’t currently know of a 
supplier, so can anyone else offer names? 
Thompson is also in need of a manual for 
the printer; can someone supply a copy? 
The sample printout he sent had charac- 
ters missing in several places, and some 
strange non-standard characters had been 
inserted at odd points. Missing characters 
are often a function of poor electrical con- 
nections between computer and printer, 
and the same fault can cause spurious 
characters. 

Some very presentable prints of graphs 
(see illustration) were sent in by Peter 
Hamill. They were printed by a Tandy 
CGP-115 printer/plotter, from Ease/ data 
which had been saved to a ram file and 
then converted into a form suitable for the 
CGP. The routine for conversion was pro- 
vided in the Quanta newsletter in Novem- 
ber 1986, by J Stevens. The printer was 
quite cheap, but is out-of-production now; 
it might still be obtainable secondhand. If 
any other user needs help with graphs from 
this model, we can put him/her in touch 
with Hamill. The latter also mentioned an 
indexing routine for articles, documents 
etc, whichis available (to Quanta members) 
from the Quanta library under the name 
Indexer (by Hugh Miall). 

Reading a reader's letter reminded me 


how contradictory are the impressions pur- 
chasers get of suppliers. Several people 
have said to me (and I've said myself) that 
Miracle Systems do not like answering 
letters; on the other hand, more people 
have given me instances of how helpful 
and generous Miracle have been in deal- 
ing with problems, going so far as to re- 
place goods free-of-charge, and despatch 
goods without first requesting payment, in 
situations where there was no reason for 
the customer to expect to be treated so 
well. Longevity can generally be taken as a 
sign of reasonable customer service, in 
this business, and it is not by accident that 
Miracle, Digital Precision and TK 
Computerware have been with us for most 
or allofthe QL's lifespan. There have been 
quite a few letters that | have written to 
suppliers over the past four years that have 
not received any answer, but | cannot 
recollect any instance where either D P or 
T K did not respond, and quickly. 

The copy for the June issue had only just 
been sent off when T K Computerware 
called to say they had been contacted by 
Mario Peer Bien at the same time as he 
wrote to QL World, and that was the first 
they knew of his not receiving his car- 
tridges. It is a bit late now (several months 
later) to start chasing the postal authorities 
about the package (which was despatched 
on 4th January last), but they will do so 
anyway. Ifthe goods you order don’t arrive, 
let the suppliers know about it within a 
reasonable time. Don't go to the extreme, 
though; one supplier called to say more 
than one customer had called at Easter 
time to complain about non-delivery of 
software ordered during the previous day 
or two, apparently quite oblivious of the fact 
that the postal service does not carry on as 
normal all through holiday periods (also, 
some people in business do like to take the 
odd day’s holiday at such times). T K also 
commented that K Blundell’s request for 
a replacement for his copy of QSpe// was 
not being delayed by them, but had to be 
passed through other hands as well as 
theirs, since the program has not been sold 
for several years. It is only when a small 
batch of similar requests has accumulated 
that T K can get supplies of such out-of- 
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date items. 

Hopefully, the change to a higher VAT 
rate will have passed without us having 
received a shoal of letters of complaint. 
Adverts placed before the budget — when 
suppliers had no idea the VAT rate was 
about to change —will have appeared with 
prices based on the old rate. Suppliers 
can't afford to pay the extra 21/2% them- 
selves, onitems supplied after the new rate 
came into effect, and they will be charging 
customers at the new rate. Bear in mind 
that advertisers (and magazines) can be 
held only to their advertised prices, not to 
the government's previous tax rate. 

Jens Wildgruber wrote from Germany, 
about his experiences with Minerva V1.82. 
He is generally pleased with it, but has 
noted some incompatibility problems, for 
which he offered some ‘work-arounds’. The 
SDUMP command on the Trump Card is 
disabled, unless another job is active in the 
background, and he suggests (for users of 
QPac) setting SYSMON or ALARM work- 
ing. As noted previously, D P’s Turbowon't 
start running with the usual CHARGE com- 
mand, and you need to use EX 
PARSER_TASK (or equivalent) to start it 
off. Uitraprint (also from DP) crashes when 
used with its original extensions, but is ok 
if Turbo Toolkit is used instead. Turbo- 
compiled tasks work in 1-screen mode, but 
not in 2-screen mode, unless a change of 
address is made in the compiled task; he 
suggests replacing the address$28010 by 
(ver$(-2)+16), starting atbyte 178 and 278. 
Hope that means more to you than it does 
to me! Wildgruber ends his letter by ex- 
pressing the hope that QView will now stop 
developing Minerva and concentrate on 
making it work with other QL software. 

CR Stephenson has received a full re- 
fund fora QL returned to EEC Ltd. and says 
he accepts that the delay in getting his 
money back was entirely accidental. | don’t 
recollect seeing any other complaint about 
this supplier, so this incident would seem 
likely to be a ‘one-off’. 

We never go long without receiving a 
letter about printing problems, and the lat- 
est one comes from P Land. He has a 
Citizen 124D, and gets double-spaced 
output from both Quill and Abacus, but 
single-spaced from programs obtained from 
the book The Working Sinclair (by David 
Lawrence). The obvious reason would 
seem to be that he has failed to use the 
Design screen inthe Psion programs to set 
the Spacing to 0, although the default set- 
ting is 0 and he (or someone else) would 
have previously had to change the setting 
to 1 to give output such as in his letter. If you 
don’t read the User Guide, or do some 
tests, the menu options can be confusing, 
and | can see someone inserting the wrong 
number for the right reason, so to speak. 
Another possibility is that his Printer_Dat 
file(s) contains the command to give a Line 
Feed with every Carriage Return, and his 
printer may automatically do that anyway, 
with the result that there are two line feeds 
for every Carriage return. 
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The next All Formats Compu- 
ter Fair will take place at the 
New Horticultural Hall, West- 
minster, London on Saturday 
22 June from 10am to 5pm. 
Tickets are £3, Anew recorded 


information line about the fairs 
is open on 0898 299 389, 


THOR 
BULLETIN 


Thor enthusiast Malcolm Smith 
has sent the first copy of Mjolnir 
~ the Unofficial Thor Users’ 
Magazine, from Norway, inhis 
own words ‘a simple, honest 
eight-page affair’ containing 
letters in response to his origi- 
nal appeals for interest, some 
tips, and many queries. The 
bulletin is very simply pro- 
duced by photocopier, but 
clearly printed and laid out 
(with the exception of one page 
which perhaps should have 
been retyped to save space). 

Mjolnir looks to QL World 
like a simple and honest at- 
tempt to start a Thor self-help 
group which, from the com- 
ments we receive, is sorely 
needed. Malcolm tentatively 
suggests a starting subscrip- 
tion of £5 for four issues, and 
the pilotissue available for40p. 
Norway, he points out, is more 
expensive than the rest of Eu- 
rope, and we can confirm that 
it is not the ideal place to put 
down in at 11 o'clock at night 
with electrical problems and 
no hotel booking. 

Contact Malcolm at Statsrad 
Ihlensvei 66B, N-2010 
Strommen, Norway. Nodoubt 
he would appreciate an Inter- 
national Reply Coupon with 
general enquiries. 
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producers of interesting pro- 
| grams will be invited. 


Dutch user group Sin_QL_Air 
report that the first Continen- 
tal Pure QL Microfair in 
Eindhoven, Holland on May 
6th went well. 

CHM Biemans, Editor of the 
bulletin Quasar, writes: “Mira- 
cle introduced the Gold Card 
inthe Netherlands, and Digital 
Precision’s Freddy Vaccha held 
his inaugural Perfection 
speech, during the first Conti- 
nental Pure Microfair in 
Eindhoven. In St. Joriscollege 
Schoolin Eindhoven there were 
a considerable quantity of OL 
users from all over Europe, 
hoping to get the first release of 
DP’s new wordprocessor Per- 
fection. In the beginning it 
seemed like a speech about the 
whole of DP’s list except Per- 
fection, but after some hints 
that his time was up, finally the 
new WP was demonstrated 
and it looked so good that sev- 
eral users bought the test 
version straight away, to get 
the complete program deliv- 
ered after some weeks. 

“This type of lecture/dem- 
onstration was so popular that 
it will be continued at future 
meetings, where one or two 


A DUTCH TREAT 


“Cowo from Switzerland 
demonstrated the newly-re- 
named program QTop, with 
many utilities and multitasking 
features. This program also 
looked good and many visi- 
tors bought one after a clear 
audio-visual presentation. 

” After the teach-in, there was 
a lecture from the Belgian 
Progs, with the recently devel- 
oped DataDesign, which 
updated the previous QL 
World test of the program. 

“The final lecture came from 
our own members about their 
QL-Unique system. It contains 
hotkey and multitasking con- 
figurations so that each user 
can devise a personal configu- 
ration to suit his or her needs. 
The club’s promoter on this 
subject is Laurens Kremer, 
Magelerweg 53, 7683 VM Den 
Ham, Netherlands. 

“The most surprising feature 
of the fair is the introduction 
and demonstration of the new 
Gold Card from Miracle Sys- 
tems. This provides a QL68000 
2MB withaspeed of 12. 16MHz, 
full 16-bit width, to fit into the 
QL’s expansion slot instead of 
the Trump Card. It includes a 
battery-backed real time clock / 
calendar, and the disk drives 


can handle 1.44MB or 3.2MB 
disks. 

“Phil Borman of Quanta had 
been asked to bring copies of 
The Definitive Handbook by Jan 
Jones, and told us that about 20 
had been sold. The charming 
team from EEC were there, and 
weare only sorry that they had 
only a few Keyboard-90 Inter- 
faces available. Jurgen 
Falkenburg himself could not 
be there. We also missed Lear 
with their PCB-CAD program, 
and don’t understand why 
there is not more publicity 
about this nice item, which we 
are sure many users would be 
interested in. 

“Laurence Reeves of OView, 
together with TF Services, also 
had too few of the newest 
Minerva V1.89 roms, but they 
promised us that soon this new 
version will be ready for mail- 
ing, with the newest manual. | 

“We had a very good first 
continental fair in Holland.” 

Sin_QL_Air’s foreign contact 
person is Marco Holmer, J P 
Coenstr. 61, 3531 EN Utrecht, 
Netherelands. The Member- 
ship Secretary is Bob Visser, 
Snelrewaard 6, 2904 SN 
Capelle, a/d Ijssel, Nether- 
lands. 


Archive Desktop 
Bug Probe 


Robin Stevenson reports: 
“Several readers have had 
problems with the to-do list 
program from the Archive 
Desktop series, and the cause 
seems to bea bug in Archive. If 
Archive files are reset or se- 
lected, when the file has only 
just been created, under cer- 


tain (as yet unidentified) cir- 
cumstances, Archive goes 
haywire, and starts filling the 
drive with blank records. 

To avoid this situation in the 
to-do list, the program should 
be modified so that there is 
never an empty file. Add the 
following lines to the end of 


the ‘TODOFILE’ procedure. An 
‘end of file’ record will be in- 
serted when you create a new 
list file: , 


let DATE$ = ‘2099/12/31 
let DAYS = days (DATE$) 
let TEXT$ = ‘END OF FILE’ 
append 


“My apologies to readers who 
have struggled with this. [f 
anyone can shed more light on 
the bug, perhaps they could 
write to Open Channel with 
details.” 
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USER GUIDE 


In the fifth part of our New User Guide, Mike 
Lloyd looks at data statements in Superbasic, SECTI ON 
and the usual data input sources; keyboard, 
microdrive and floppy disks. 


o far in this series all the information given to the computer has come from SuperBasic 
c commands such as ‘LET x = 4’. In real life, programs have to cope with data entered by 


users. 
SuperBasic is extremely rich in keywords associated with obtaining data from a variety of 
sources. There are three main sources of data input available to Basic programmers: the keyboard, 
microdrive and floppy disk files, and from special data statements within SuperBasic programs themselves. 
The latter will be dealt with on another occasion. 
The keyboard provides the most direct contact with the user, and often provides the most problems. Users 
are notoriously prone to typing in the wrong thing, so the only way to trust them is not to trust them at all. 
Data files on microdrives or disks and data statements within SuperBasic programs can be relied on to 
contain valid information provided that the programmer has full control over what is placed in them. If they 
contain information written by users then it is usually best to treat their contents with caution. 
Input to a SuperBasic program can be obtained using the keyword INPUT. INPUT is very closely related 
tothe PRINT statement with which you are now familiar. Atits simplest, INPUT is followed by a single variable 


INPUT aie 


INPUT number 


If the above line is typed in as a direct command, the cursor will flash on the next free line of the default 
window. Anything typed at the keyboard will appear in that window until the Enter key is pressed, at which 
point the computer will attempt to make the variable ‘number’ equal to whatever has been typed in. Try it out, 
and prove that the input has been accepted by typing the following command: 


& PRINT number 


With luck, the output from the PRINT command will be identical to the input from the INPUT command. 
However, if what you typed was not a valid number the computer will respond with an error message, and 
if you typed a very large or a very small number the computer will have displayed the result in scientific 
notation. Sticking to numbers with less than six digits will avoid the distraction of scientific notation for the 
moment. 

INPUT's similarity to PRINT shows in the way that it can be preceded by an AT statement to determine 
where onthe screen the inputline will appear; itis affectedby PAPER and INK statements; achannel number 
canbe included in INPUT statements; and any number of inputs can be obtained provided that each variable 
name is separated by a valid print separator. It is therefore possible to write code such as: 


AT#2; 4, 7 
PAPER#2, 5 
INPUT#2; A, BS, C 


Basic’s fondness of halting processing with error messages is one ofits biggest weaknesses, andnowhere 
is this more irritating than in the way in which Basic objects to invalid data entered in response to INPUT 
commands. Fortunately, INPUT statements can also accept text data simply by using string variables, such 
as: 


INPUT text$ 
No matter whatis typed into a text variable the QL will never complain that the input is invalid, so itis a good 
& rule always to use string variables with INPUT statements. Ifnecessary, numbers can be converted, or more 


properly ‘coerced’, from text format to the computer's internal numeric format. This is demonstrated by the 
following program fragment: 
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INPUT text$ 
LET square = text$ * 2 


N For coercion to work properly the string must begin with a valid number, for example it might rear el 
COERCIO “123 High Street”, otherwise we are back to an error message. 


The simplest way to obtain trouble-free numeric input has been published in Sinclair QL World 
previously. The trick is to add a leading zero to all strings before coercing them. Listing one shows 
exactly how this can be done by rewriting last month’s multiplication table program so that it accepts 
input from the user before printing a table. 


LISTING 1 - MODIFIED MULTIPLICATION TABLE 


100 PRINT "MULTIPLICATION TABLE" 
110 INPUT "Enter number "; INFO$ 
120 LET NUMBER = "0" & INFO$ 
130 IF NUMBER = 0 THEN STOP 


140 CLS 
150 LET COUNT = 1 
160 PRINT NUMBER; " x "; COUNT; "= "; 


170 PRINT NUMBER * COUNT 

180 IF COUNT = 12 THEN GOTO 100 
190 LET COUNT = COUNT+1 

200 GOTO 160 


As you begin to develop programs requiring user input, the following sequence of statements will 
feature regularly in your programs: 


PRINT “Enter your name" 


INPUT name$ E 


Computer language developers have added an extra facility to the INPUT command to assist in 
this circumstance. You can put text strings into an INPUT statement which will be printed out prior 
to the cursor appearing for input. The two lines above can be encapsulated in a single INPUT 
command such as: 


INPUT “Enter your name” \ name$ 


You should by now be well acquainted with the associate between the keyboard and input on the 
one hand and screen windows and output on the other. Communication between the computer and 
these devices is by means of ‘channels’, which can be imagined as conduits for Ascii characters. 
The concept of channels in central to the way the Qdos and SuperBasic make communications 
easy within any QL system. 

When the QL is switched on three channels are opened by default, one for each of the screen 
windows. As a special arrangement for typing commands the keyboard is initially associated with 
the #0 window, also known as the command window. 

When an INPUT statement is used, the keyboard is temporarily attached to the #1 window, aka 
the default window. If the INPUT statement includes the #2 channel identifier, the input appears in 
the #2, or listing, window. As we will soon learn, channels can also be opened to a printer and to 
files on microdrives and diskettes. 

To open other windows new channels are designated with the OPEN command. OPEN must be 

O P E N followed by a channel number and by a device identifier. The identifier can be extended if necessary . 
to include all sorts of extra information which will where possible be avoided in order to keep things 
simple. 

The five device identifiers commonly used on QLs are listed in Figure one, although QDOS 
recognises a sixth, NET, which is used to connect QLs together in a network. Third party 
manufacturers have extended QDOS to recognise devices not originally included in the basic QL. 
The best examples are the now ubiquitous FLP1_ and FLP2_ device names for floppy disks. 


QL DEVICES AND DEVICE IDENTIFIERS 


| scr_ (INPUT not allowed) 
t= con_ {INPUT allowed) 


f- ey serl_ & ser2_ 


ri ~,  fipi_ & = flp2_ 


mdv1_ & mdv2_ 


to be used in association with them, but windows opened as screens do not permit INPUT to be 


There are two types of screen window. Windows opened as consoles allow the INPUT command oe | 
used. All three default windows are consoles. 
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QL World / QLAW 


The QL in the 


Giant Joint 


LAW (the QL Advancement Working Group) in co- 
operation with Sinclair QL World, has drawn up a de- 
tailed questionnaire with the aim of producing acom- 
prehensive profile of the OL-using community in the 
1990s. 

QLAW is a non profit making interest group founded by 
Public Health Physician, medical statistician and QL user Dr. 
Sohail Bhatti. The group's long-term aim is to discover what QL 
users want from their machines, to co-ordinate skill, experience 
and talent within the QL community, to provide a pool of 
expertise to beta-test new developments on request, and ulti- 
mately to work towards the development of a ‘Super QL’ with 
the co-operation and knowledge of major developers. 

Asa firststep towards this goal, QL World is publishing QLAW’s 
questionnaire, along with a series of questions designed to find 
out more about what QL World readers want from their maga- 
zine. 

The questionnaires will be analysed and the results maintained 
on a database by QLAW. Names and addresses are requested. 
QLAW stresses that confidentiality will be maintained; only 
official representatives will have access to the information in the 
questionnaires, [f you do not wish to include your name and/or 
address, however, your replies will still be of interest. 


Please read the notes! 


using the “other, jo 
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READER 
QUESTIONNAIRE 


QLAW has no association with QL World, Maxwell Specialist Magazines or MCPC Ltd. 


Notes: 1. A Levels-pre-higher education. If studying for a Degree, tick box for appropriate establishment & put course under “other” 2. Give the title of the job as well, 
space. If retired then tick RETIRED box and also the box which most closely represents the major occupation of your life 6. Sinclair Rom name is 
obtained by typing PRINT VERS. Fill appropriate box and for each QL put the rem on dotted lines 7. Gold card owners should fill in “Disk+Memory tnertee 
2Mb as a capacity. Trump card drive capacity is number of drives supported. Give as may details as you can about any machines or peripherals you use e.g. RA 
disk, make, etc, 13, Whether the option exists or not give your opinion on your most desirable one 18. The Quill refers to the program from Gilsoft NOT the word-processor. 
Use the current exchange rate to calculate £ equivalents. Filling in this questionnaire and returning it implies consent to contents being placed on a computer database. 


Weare particularly keen to know as fully as possible the details 
of your machines and how you use them, so please try to answer 
every question. Sinclair roms can be identified by typing PRINT 
VER¢ and reading back the rom (JS, JM etc.) from the screen. 
Minerva owners will already know their version numbers. 

We suggest that you look through the questionnaire before 
filling it in, as some items may appear in greater depth in later 
questions. 


This questionnaire is also appearing in a similar form in the 
monthly Quanta bulletin, and in CGH Services’ QL Technical 
Review. 

QL users wishing to join QLAW or learn more about the 
group’s stated aims will find more information in this month’s 
QL Scene. 


A typical response to published questionnaires is around two per 
cent of readers canvassed. For a few quiet moments and the price of a 
stamp, you could be helping to put the QL ahead of the crowd in the} 
1990s. Please return your questionnaire to us at QLAW! 

There is no fixed time deadline, but Dr. Bhatti hopes to produce an 
analysis by August 1991. This questionnaire can be pulled out of your 
QL World, leaving the rest of the issue infact. 


ivin 
har 


QUESTIONNAIRE | 


All names and addresses remain confidential and will not be released without consent. Please read the notes at the beginning before answering the questions. 


Personal details: Male (J Female Age. 


1, Education: Oj O O for Scotland H Grade = A level 
(HIGHEST ATTAINED) OLevels ALevels College Polytech University Otheticicsssscsmsssinisnnsannsencaniee 


2. Occupation: Teaching C] Managerial Divinity other / what? 

(Fill in Professional O Scientific /Tech Student ands ena eon Soenegith 

two if retired) Skilled Manual Computing O Medical 
Retired LI Manual 0 Arts 


| 3. Gross Income: O O oO C] | CI 
(1K=1,000) <£5000 £5-10K £10-20K £20-30K £30K+ Not te 


4,Marital Status: Married (1 Single Widowed Divorced 


5. Years with QL: () a Oo Oo oO im 
<1 1-2 2-3 3-4 4-5 5 6+ 


6. How many working QLs do you have? ] 
(Put roms beside box for each OL if known) 0 


7. Which of the following peripherals do you have? 
How many? Want it? Yes! 


Internal memory setuavenvstoessiness — EAGT TIALIY IRs ccsssaniceieesisanns Deena Fea BU TR ices seeded onateatns eeu at snaes vai vbuecalcudingiontycastintsveu 


External memory sasnerisoaapaccennas. LOWMAN Th ccicssscraerrcissiveess MaTUUFACHUIRET .iscocssocesioassvssissersceeiacaasinsasatesarnananuasisasrnegenavins 


Printer aartstosnssoarcanng | WR LMCEY TACLEL COATIN ONTED ssc cesses essa sarservek i cexeivs siahin shanna diacdsadancssdedbasdtsensncseciadsesndoroataiaacsenrina 


Disk interface wasmmnaun - WEA FACHIT en secodenisicmeveabaan ensercnmannatreermunanni aa eeenenemetremeesneerteatees 


Trump Card wrmmiascn: TOW Matty Kisseaciarnicnars DAVE CAPAC? <cscasisciminirsivascneynssqontionninnaininnete 


Disk + memory interface (] occ How many K sees MakeHinGdl el: .eccsvccsceavevereciovcanstriancinaveavsnedvnqicinaquciivetenivdi vee 


Hard disk interface Lpadicaatesttzore > IA RMU T Rea CERIO cc ents nctc coe svitaceaas asa tas cusMiate ciel Ra llinse carcachnclncuth uiteatdeinecemntehesartelatanetelant 
Keyboard 


System box/ cabinet mommies Manufacturer aniconmesaciannamsmni mmm aanicmummmenemainanamannas meuneaminn 


Manufacturer... 


Disk drives [3.5in] semen CAPACI scccncscnccvsecenaics K Manufacturer / model siciecscascorssacivcssessenescsuinencneenesecians 
[5.25in] 


Monitor ga rdsdeatiadscuteede. AM LELRTLUT ENC URL ON, cuheasce'sus parca ahalpeuus de wuls aslo su deve detasbind cp lah at seayniantdi deceit vessnninntencavdeveetoeniiale 


Digitiser /Scanner sSrciadoasusanaeay : OMURTULEA CULITER cs gdeda cadata cninassetatptbdaveraenvesoad donssavuarensunscddecessasblouapeeetrddreiraesuarchvtutscausaivesesienriee 


Eprom programmer steeicnsracesseneet, WM PAIINI PAREN OR 2 scc cs ssecnutin ssecenies sats ossbanoseninndpatodsoGntansaosnd tenssecibhsncsnaseniaadonentcsasneddonedasenieetens 


Centronics interface oll ateseaccenedervaien + TW LANVE PACHIAT OR pacncs acter iucuerswersteaa eavav rene eae theakccun serena eet martin nome men en nnariatrats 


Mouse civievadensetateves,  WUATIUPAGETIDGR serestrerdvarsvacrevns vavdorcerventdnves toeriuisreaitrorduaneedeein du peeiuavedseriverseinecs aneieciactisinetraNeters 
CAPS lock led ae .... Manufacturer... 


Backplane Lal csskeasssssensetanas.” IM OTUURACTOMR ccs hacshi0s Se anass cats hdatacendncs Siainasascenisedacaccs daikineabicasansspaaadtesdadamssusslabasntaieaainieh i 


8. How many other /ocal QL users do you know? [] 6-15 


9. Do you have another QL-specific machine? 
If so what make and model? Lj AtariST 


10. Do you use any other computer? No: a3 
PC(IBM compat) C1 Dragon Spectrum CPC 
ST C1] Tandy C64 MSX 


Amiga Oh PCW MSX Console (any) 
BBC [J Archimedes Macintosh Other (what?) 


SPECI CLELAIIS: (SKS CLE) series ecanserensncerd tibia chen eavenctan na nas sates deretans dovasiaeiGanseverstivdaatana pred ratenidieear tied ceatenarns namisiene ni iazenenan 
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11. What is your use of the QL? (0=nil, 1=rarely, 2=sometimes, 3=regularly, 4=frequently, 5=always) 


Word-processing Basic Language 


MaGhine GOGO. ase scscceczecicsonsavaseustissvaieescecaiacssarn Computer Languages ........ssssecsecesesisseeesneriss 


Databases Graphic! Desi eM evccsssesstessssssenedsceaneecenssnsssrsensecessizets 


Educational ANNI ES e sasiccsn ee cesebekcacsdes Was oscnennncytaencstadevicecp oak 


Adventures Program Development 


Desk Top Publishing BUSINOSS: .xscsserecsarsciaceeereisescteneamaanecderesnmmescuseaes 


Hardware Design Other (What?) \. sccscsceevisteenczscces 


12. How many hours did you spend with your QL in the last typical week? 
J O O O O 
<1 1-2 2-4 4-7 8-14 15-28 29+ 


13. Which of the following, would you most wish? (0=no, 1=perhaps, 2=useful, 3great, 4=love it) 


Any disk drive «0... 14MB Disk drive ZOMB Disk tive ......c:cccssessecseee 
Hard disk drive 512K Memory expansion .........66. GOld Card vc cssssscseceseesseneeees 


Better keyboard Better display resolution Better SOUN .......s.sscssssssssseseseees 


Hrs with non-QL 


PIU I PC cissnspassersivnossseveiscscnied 
Use PC peripherals 
QL ona PC 


Better printer Cabinet/case WIGKIUGE ccd siseivastainnesnir vend acnioansis 


14. What is your main interest in the QL? (fill two only) 


Word processing [_] SuperBasic [_] Machine Code (] Languages (] Databases (] Graphics 


L] Educational (] Games (J 


Adventures [] Prog Develpt [] DTP Business [] Hardware (] Simulations) Spreadsheets (] Other 


15. Which is the machine you most want to buy? 
Archimedes 3000 = 386 PC O “SuperQL” AtariTT 


Macintosh Classic [1 Thor 0 Amiga 3000 [1 Amiga 1500 


16. How much money (total) have you spent on buying software for the QL? 


17. Have you received a QLAW questionnaire from another source? yes/no 


L] <£100 CJ £100-500 CJ £500-1000 Cj £1-2000 


C) MegaSTE 
O Other 


WHETE? sevcsninsaitesernenesecae 


18. How well do you know:? O0=ignorant 1=passing acquaintance 2=understand 3=proficient 4=expert 


PerfectiONn ....c..c:ccceseceeceeeeees Editor 


FOrtraN innconscrrcrcnience SUperBasic a eaiadas tect Sitbicaacesteieeberae SELINA seinsatecqatepintechetaenaiadhacdaatad 
QLiberator Turbo PTCRIVS octaiseecrcittisapiuusedieileaed PRDORUS cassis caches 
BASE] scxisericnupecsrrassnenienrentens SDEOKGs ceninesmauunwhen TOOUA2 octieeciaiarminas. PASH bath: ecanenieccndien 


DataDesign PageDesigner? uu... 


ASS@MDIEF .......ccccccescesseeceeeeeees SOLON sccicecssrcarcrrciinieetisinents 


. Hardwre Design ................. Cash Trader 


* See notes 
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QUESTIONNAIRE | | 


19. Which word processor (if any) do you most often use? 


20. For QL information, do you read: 
QL World Quanta QL Technical Review 
How frequently? 
Since when? 
How satisfied? 
(Rate 1 for poor to 10 for good) 


21. How do you obtain your copy of Sinclair QL World? 
Newsagents shelf [] Newsagent order [] Magazine subscription(.] Borrowed 1 
Do you often see QL World on your newsagents shelves? Yes/No 


22. Do you ever experience difficulty getting QL World from: 
Your usual source? Yes/No Any alternative sources? Yes/No Through you subscription Yes/No 
A OMMUINTETTES TE AITY VF ic-ssisacsasiaonsvenarsensensnsiniaeseosctsasainesetiniascnerasinveaaveiansssatensatiedinaine 


23. Why do you read OL World? Please indicate importance of factor: 
Very 

Right price 

Supplier advertising 

News and new product information 

Hardware reviews 

Software reviews 

Tips on using commercial programs 

SuperBasic programming 

Machine code programming 

Problem solving (any kind) 


General interest 


24. In general, do you find QL World: 
PVT CO an ss siteascessnnnnsiipantinnctcestsensnslcnndedisesecnantua wsansisieailaadioifennl onsen nda ntyasiodiaiedes ier evinlud vaieah dedi vevdctavitvel dlvdeenicannnicgneteaus 
Dwells too much on particular areas (Which?)........s.srssosocvorrsarssesessessscssotesnesessecneacesersensenssesseaeetenecasanensseataneeseavesseseutavesersees 


25. Is there any kind of article you would like to see more frequently in QL World? 


26. In general, do you find articles in QL World: 
Too simple 1 Too technical 1 Just right 0) 


27. On a scale of 1 (poor) to 10 (good), how do you rate: 
‘he avenalll) presenta Gini tot COTS MOT sit spccnucassevenoanncnieacdanaenZevedaey used szectnng cet dCae eee tunduebee cela uebddete aoedenudtaiaansybes 
‘Ehe overall walige ORCL Worle? ci ccs axaiss caea snags cused Sencducenden sha cn aighnt eilcie san sedaagcavennshGubadednens alabsntasseniAnadnaia toatdassuanenrunederdineeat 


28. Would you be interested in joining or supporting QLAW? Yes (] 
For more information on QLAW, see QL Scene, page 19. 


POST THIS QUESTIONNAIRE TO QLAW, 4 WASDALE AVE, BLACKBURN, ENGLAND, BB1 1XD. © OLAW 1991 QW. 
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Aprinter can be attached to the QL via one of the two serial port sockets at the back of the computer. 
Serial ports are so called because each of the bits of a byte of information are passed one after the 
other down a single wire, in serial fashion. The alternative arrangement is to have the bits of each 
byte travel simultaneously down eight wires, ie in parallel. 

All QLs have two microdrives units fitted to their superstructure to allow files to be saves and 
accessed. When a channel is opened to a microdrive it is connected to a named file on a microdrive 
cartridge loaded onto the specified microdrive. 

These days, many QL systems include one or two floppy disk units. Floppy disk drives are much 
faster and more reliable than microdrives, and floppy disks hold about seven times more information 
than a microdrive cartridge. Floppy disks are also extremely cheap, working out at around 75p per 
megabyte (roughly 1,000 kilobytes or a million bytes) whereas £20 worth of microdrives are needed 
to hold the same amount. Of course, before switching to floppy disks the cost of the disk drive must 
be considered, but the QL becomes a much more useful, responsive, reliable and fast machine with 
a disk drive attached. 

If anew screen window was required, one which needed to accept INPUT commands, it could be 
opened with the following command: 


OPEN#S, con_ 


The window will have default values for its size and colour which can be changed with appropriate 
commands, such as: 


WINDOW#S, 140, 20, 10, 10 
PAPER#S, 2 
INK#3, 0 


There is no requirement to open channels with consecutive numbers, although to do so is usually 
agood idea. Itis also advisable to re-use channels, simply by opening them as anew device. Novices 
often fall into the trap of unnecessarily opening large numbers of windows at various screen 
locations. A more economical approach is to have just one window channel which can be relocated 
to suit what is being printed at the time. 


In order to use a printer in SuperBasic a command such as: 
OPEN#5, ser1_ 


must be used. 

More often than not the device name needs extending to include essential parameters so that the 
computer and the printer are synchronised. Additionally, the speed of data transmission might need 
to be changed using the BAUD command, but these refinements will be discussed in a later part of 
the New User Guide. 


Once a printer channel is open, the PRINT command can be used to send data to the printer, for 
instance: 


INPUT “Type your name.”, name$ 
PRINT#5, “Your name is ”; name$ 


Some commands associated with screen channels, such as PAPER and INK, have no effect on 
the printer AT and CLS and all of the graphics commands are also prevented from reaching the 
printer. A useful substitute for AT which can be used with printers and screen windows is TO, which 
moves the print position to a specified character position on the current line. In SuperBasic TO is 
embedded in a PRINT statement, as in: 


PRINT#5, “This is the"; TO 20; “20th tab stop” 


TO cannot be used to move the print position to the left of its current location or to the right of the 
window or page print area. 


Programs can be listed to the printer by adding the appropriate channel number, such as: 
LIST#5 


Sometimes the last line of text sent to the printer will not be printed because it is held in a memory 
location called a buffer until some more text comes along to shunt it to the printer. It is possible to 
force the last few characters out of the buffer by closing the channel to the printer. Unsurprisingly, 
the keyword is CLOSE and the format for the command is: 


CLOSE#5 


By the way, it is a good idea to get in the habit of always using the same channel number for the 
printer. 

Information is stored on microdrive cartridges and floppy disks in files. A file can contain a 
SuperBasic program, commercial software such as Psion Quill, data such as a word-processed file 
or some spreadsheet figures, or a representation of a screen display. 
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TO 


CLOSE 


CAVEAT! 


SAVE and 
LOAD 


LRUN 


To open a new file using SuperBasic, a command from the OPEN family is followed by the name 
of the device and the file itself, eg: 


OPEN_NEW#4, mdv 1_demofile 


Once the file has been opened it can be written to using the PRINT command in exactly the same 
way as PRINT has been used for screen windows and the printer. 


PRINT#4, “Here is some stored text” 
PRINT#4, “- and a second line of text” 


As was the case with the printer, such incidentals as colour information and the AT command 
cannot be used with files. 


Once you have finished writing to the file it can be closed with the CLOSE command: 
CLOSE#4 


It is extremely important to remember to close all channels linked to files before switching off the 
QL or removing the microdrive cartridge or floppy disk from its drive. If a file is open when the QL 
is turned off its contents will almost certainly be destroyed, and other files on the same medium may 
no longer be accessible. If you accidentally remove a file medium without closing channels 
connected to you can usually avoid disaster by re-inserting the correct medium. However, there 
is no substitute for rigorously following this advice: 


ALWAYS CLOSE FILE CHANNELS 


File contents are accessed by connecting them to a channel with one of two keywords from the 
OPEN family: OPEN or OPEN_IN. OPEN allows both PRINT and INPUT commands to work, but 
OPEN_IN only allows INPUT commands to be used, thus protecting the contents of your file from 
being overwritten by the accidental use of the PRINT command. 

It is good practice, at least for the time being, to use OPEN_IN rather than OPEN to read back 
information from files. You would only use OPEN to write to files which already exist and which 
contain data you no longer want to keep. To retrieve the two lines of text sent to the file above and 
print them on the screen, the following commands are required: 


OPEN_IN#6, mdv 1_demofile 
INPUT#6, text$ 

PRINT text$ 

INPUT#6, text$ 

PRINT text$ 

CLOSE#6 


Points to note are the choice of OPEN_IN as the safest way of accessing a file for read-only 
operations, the use of INPUT to read back each line from the file and the CLOSE statement at the 
end of the sequence. the program as it stands is fine for a two-line file, but for longer files some sort 
of loop needs to be developed containing the INPUT and PRINT statements. 

While it is possible to save a program listing like this: 


OPEN_NEW3#3, flp 1_program 
LIST#3 
CLOSE#3 
it is rarely a good idea. 
SuperBasic includes a single command called SAVE which does all of this. The equivalent SAVE 
command to the sequence above is simply: 
SAVE flp_1 program 
To retrieve the program into memory again, type: 
LOAD flp1_program 


Once the program has been loaded it can be LISTed, EDITed and RUN. Alternatively, if all you 
want to do is run the program, type: 


LRUN flp 1_program 

LRUN is shorthand for ‘LOAD and RUN’. SuperBasic programs can be ‘daisychained’ so that 
each program loads its successor by including a LRUN command in the program. However, it is 
a rule that only one SuperBasic program can be in the QL's memory at one time, so both LRUN 
and LOAD have the effect of wiping out any program already in memory. 
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Be R. 


he value and usefulness of the QL 
and of the software available for 
it is tempered by the degree of 
simplicity with which that 


| software available can be made to run 


smoothly. While there are undoubtedly 
several examples of good software to help 
keep track of one’s personal finances and 
even those of small businesses, many 
people would be satisfied with a simple 
but effective application which did not 
require hours studying the manual or 
elaborate setting-up procedures. 

The beauty of the Psion programs and 
the testament to their continued usefulness 
is the ease with which data can be entered 
into themand useful information obtained 
immediately. While a very substantial 
number of articles have appeared 
describing various uses for Archive, its 
close relative Abacus has tended to receive 
less attention until recently. 


Reconciliation 


The following is a simple one-screen 
application to enable reconciliation of bank 
statements with cheque-book records. 
There will be those that have got such a 
tight control of their personal finances 
that they will have invested in a much 
more comprehensive piece of software to 
do this and other things for them. But, for 
quite a number of people, some simple, 
straightforward method of carrying out 
this regularly-occurring procedure would 
be very welcome. 

Where do you begin if you decide to 
attempt a reconciliation? What do you 
make of all those standing order payments, 
cash machine receipts, cheque stubs, bank 
charges — or bank interest if you're the 
thrifty type —- and countless other details 
of the average current account/ At first 


F3 :C(+0}R{-3)+C{+0]R[-2) 
Fl2 :askn(Cl-1)R{+a]+" ™) 
Fl17 :askn(c[-1]R[+0]+" ") 
Pio :-askn(C[{-L]R[~O}]+™ ")° 
F20 :C(+O]R[-3]+c(+0]R[-2] 
F25 :C[+Oj]R(~3)+C(+0)RL-2] 
F35 :rept("=",width(}) 

P37 :askt("Enter month ")} 
F368) srept("-",widtn()} 

P39 :rept("-",widtn()) 


FSO :sum(C(+O]R[-10]:c{+o]R[(-2]) 


Z finance into 
an Abacus 
tutor. 


sight, it's not obvious and, unless you are 
an accountant or bookkeeper, you 
probably may not be able to devise your 
own system to reconcile your version of 
things with the bank's. 

Some years ago, I had an account with 
one of the smaller banks which provided 
statements on the back of which was a 
detailed set of instructions on how to carry 
out a reconciliation. I'm surprised that all 
banks do not provide sucha useful service. 
I decided to adapt this to the QL. I choose 
to use Abacus rather than program in 
SuperBasic as it is possible to achieve very 
useful results with a spreadsheet in a 
fraction of the time it takes to program. 
And when you want to sort out your 
finances, the last thing you want is to get 
tied up ina loop! 

The following Abacus application was 
one of the very first 1 developed back in 
the heady days of 1984 when the first QLs 
were rolling off the production line. Iam 
still using it to reconcile my cheque book 
with my bank statement and I have found 
itabsolutely invaluable. With the addition 
of extra memory, disc drives, Minerva 
and QPAC2, my six-and-a-half year old 
QL is now ten times the machine it was 
then, and beats the socks off most PCs! 

A reconciliation is basically designed to 
match every item in your records with a 
corresponding entry in the bank's record, 
ie the statement. In actual fact, it is not in 
principle necessary to do any arithmetic at 
all, merely to tick off the items as they 
appear. In practice, however, because of 
the possibility of confusion between 
several similar items such as cash- 
dispenser withdrawals, it is better to keep 
a running total of the actual amount of all 
transactions. Also, because of the time it 
takes for cheques etc, to be cleared by the 
bank, the figure the bank regards as your 


Fol +:ip(apnes(S£19-$E10)>=0.005, "NOT RECONCILED", "RECONCILED™) 


F52 :-$3B17 
F56 :Uf+o]R[-3]+C(+01R[-2) 
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Nigel Bates 


makes 
personal 


actual balance may never exactly match 
that in your records. Therefore, it is 
desirable to choose a definite point of time 
and attempt to match the cheque-book 
record with the bank statement by taking 
account of all other items which have been 
omitted in one and included in the other 
and vice versa. 

This application was designed for 
someone who prefers to keep details of all 
bank account transactions on cheque-book 
stubs. Of course, it would be possible to 
use Abacus itself to keep a list of these 
details or even to modify the application 
described below to do so, but this would 
entail a necessary degree of complexity 
which would compromise the principle of 
ease of use. In practice, as long as we 
continue to use cheque-books, this seems 
to be the most logical place to maintain a 
current record. If the day ever comes that 
all transactions are carried out 
electronically, then the application could 
be modified to take account of this. 


Full records 


To be able to use the application you will 
need to start getting into the habit of 
keeping full records of all the financial 
transactions on your bank account by 
collecting all those cash-dispenser slips 
which, previously, you may have thrown 
in the bin. Unless you are the type of 
person who can remember every penny 
you have spent and fifteen birthdays in 
your head at the same time, make a list of 
Standing Order or Direct Debit mandates 
on your bank account on a sheet of paper. 
Use your previous statements to help fill 
in the gaps in your memory. Keep this 
sheet for reference purposes and update it 
as soon as changes occur in the details. 
Make sure you always write up all cheque 
stubs fully as you make them out. Later, 
write into your cheque stubs at the correct 
places details of all other withdrawals and 
deposits made by you between the dates 
of the cheques. I find it useful to use a 
sharp pencil and to write the details in 
code form, eg 12/10 -20.00 CD (£20 
withdrawn by cash-dispenser on 12th 
October) or DD (Direct Debit) as necessary 
or make up your own. Even on a cheque 
stub, itis amazing how much information 
you can fit. 

Obviously, at the start, you will not have 
a previous reconciled balance with which 


to begin. You willhave to accept the bank's 
version of events and use the final balance 
of the most recent statement you have 
received. Write this figure in, again in 
pencil, somewhere near the top of the 
cheque-stub whose date follows the date 
of this balance. Subtract from this balance 
the amounts of any withdrawals and add 
to it the amounts of any deposits whose 
details you have written in. Don't worry if 
you think you have not remembered 
everything. Inany case, you will not know 
beforehand how much interest on your 
account you are due or, if you are not so 
lucky, how much in bank charges you 
have to pay. They need only to be taken 
account of in the month of the statement 
on which they appear; and that statement 
will give you those details. 


Set-up 


Toset up the application, first press F2 to 
get full-screen display followed by F3D A 
ENTER to turn off Abacus's auto-calculate 
oninput. Set the default display ofnumeric 
data with the units command: F3 U D 
ENTERENTER to give two decimal places. 
Change the column widths for each 
column with the grid command. Set 
column A toa width of 9 spaces by pressing 
F3 G W 9 ENTER A ENTER A ENTER. 
Change each of the widths of columns B to 
Ein the same manner setting B to 8, Cto 3, 
Dto30,and Eto8 spaces respectively. You 
may wish to blank out amounts in the 
spreadsheet which are zero by pressing F3 
DB ENTER. 

Enter the following formulae into the 
appropriate cells as given. Where textitems 
are being entered, you need only type the 
first quote ("): Abacus fills in the other for 


"a/C No." 

"DEBITS OUTSTANDING" 
"Cheque No." 
rept("-",width0) 

"(Your own account no.)" 
"Amount" 

rept("-",width0) 
sum(B6;B15) 
rept("=",width0) 

cl "CHEQUE-BOOK AND 

STATEMENT RECONCILIATION" 

D2 askt("Enter month") 
"Cheque-book balance" 
"Statement credits not in recs." 
"Subtotal" 

"Less stmt. debits not in recs." 
rept("-",width0) 

"Adjusted cheque-book balance’ 
rept("=",width0) 

“Final statement balance" 

“Add total lIdgmts. not on stmt." 
"Subtotal" 

"Less 'DEBITS OUTSTANDING" 
rept("-",wideth0) 

“Account balance" 
rept("=",width0) 

vgn 

askn(D4+"") 


askn(D5+"") 
rept("-",width0) 
E4+E5 
-askn(D8+"") 
rept("-",width0) 
E7+E8 
rept("-",width0) 
askn(D13+"") 


and useitasa blank template whenstarting 
out to do the reconciliation. You may have 
more than one account on which you wish 
to use it. 

When the day of reckoning arrives and 
you receive your bank statement, don't be 
tempted to put it aside to deal with it late. 
If there are any errors on the statement — 


E14 
E15 


ask(D14+"") 

rept("-",width)) 

E16 E13+E14 

E17 =-SB17 

E18 — rept("-",width0) 

E19 E16+E17 

E20 _ rept("-",width0) 

E19 — if(abs(SE19-SE10)>=0.005, “NOT 
RECONCILED", "RECONCILED") 


To improve the appearance of the 
application, the text in cell B5 should be 
right-justified (F3 J ENTER ENTER R 
ENTER)and thatin cells A17 and E3 should 
be centred (F3 J ENTER ENTER C ENTER). 


Automatic resize 


The rept0 function is used to separate 
different parts of the spreadsheet by 
drawing lines of dashes and double dashes. 
The inclusion of the widthO functions in 
the formula means that the lines are resized 
automatically it the column-widths are 
changed. Two extreme useful functions in 
Abacus are askt0 and askn0. These 
effectively make an Abacus spreadsheet 
behave as if it were a SuperBasic program 
by generating prompted requests for data 
entry. Both may take text parameter or, as 
here, a reference to a cell containing text. 
When the spreadsheet is executed, Abacus 
will work through these functions 
presenting them as queries in the prompt 
line at the bottom of the screen with any 
text prompts they contain. In the case of 
askt0, you may press ENTER if there is 
nothing you wish to type in. With askn0, 
however, which expects numeric input, if 
there is no number to enter you must type 
zero ('0') followed by ENTER otherwise 
Abacus will refuse to continue. 

Save this asa file called CHEQBOOK aba 


and believe me errors do occur — you will 
want to inform your bank as soon as 
possible. In my own experience, | find the 
banks are getting better at correcting their 
own errors before they get through to you; 
and if there is a mistake on the statement 
itis not unusual toseea correcting payment 
further down the sheet. 


Statement dates 


Note the date of the statement. You may, 
if you wish, carry out the reconciliation for 
any period you like; but | find it simpler to 
use the dates given at the beginning and 
end of the statement even if these do not 
correspond to a calendar month, Go 
through the cheque-book stubs for the 
period since the last statement and before 
the latest date of the present statement 
and tick off each debit which also appears 
on the bank statement. Any left unticked 
should have their amounts as numeric 
data. You can expand the space for this if 
you have a lot of debits outstanding, but 
you will need to move the formula in cell 
B17 further down and change it to cover 
the greatest range of cells; and you will 
also need to alter the formula in cell E17 
which uses an absolute cell reference. 
Changeit to refer to whatever cell you have 
moved the formula originally in B17 to. 

Press F3 X to start eXecution. The 
program prompts you for the necessary 
information it needs. Make sure you enter 
all debts as positive amounts ~the program 
will put in the signs for you. However, if 
either the starting cheque-book balance or 
the final statement balance are negative, ie 
overdrawn, then enter these with a minus 
sign in front of them. 

Abacus will ask you to type in the month 
in question. This is merely for record 
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purposes. The heart of the program is in 
two parts, the first of which basically 
corrects the deficiencies in your record 
keeping by including those unexpected 
items that have appeared on your bank 
statement, and the second part corrects the 
deficiencies of the bank statement by 
adding on deposits that you have made 
which have yet to be cleared before they 
appear in the bank's records. 


Estimate 


The program asks you for the balance 
you have estimated in your cheque-book 
up to the date of the statement. This is the 
figure you will have written in pencil at the 
bottom of the latest cheque-stub before the 
statement date and corrected for any later 
transactions of other types that may have 
occurred. The program then asks for the 
total amount of any credits that have 
appeared on your statement that you have 
not taken account of in your cheque-book 
record. This could include bank interest, 
money paid into your account from other 
accounts, etc. Next, you are asked for the 


records but which have not appeared on 
the statement. Enter this value in response 
to the prompt. Lodgements you know of 
made by other people into your account 
are probably best left out of the reckoning 
for the present. They will appear on the 
following month's statement and you will 
take account of them under the ‘Statement 
credits not in records' query of cell E5. 


Comparisons 


Abacus then goesaway and doesits sums. 
Ifevery conceivable item has been included 
correctly, the figures in cells E10 and E19 
will be identical and cell F19 will show the 
word RECONCILED, otherwise it will say 
NOT RECONCILED. This is an interesting 
example of the use of the if0 function in 
Abacus. The program compares the 
difference in the values of the contents of 
the two cells to see if it is greater than or 
equal to £0.005, ie a halfpenny. If it had 
been asked to check that they were exactly 
equal, then it would almost always be 
NOT RECONCILED as Abacus calculates 
its numbers to sixteen places of decimals 


Subtotal 


Final statement balance 
Add total idaats. mat on stat, 


Subtotal 


re 


SNS ALF 28 
EXPTY 


value of any debits which appear on your 
statement but which also you have not 
taken account of in your cheque-book 
records. This will include bank charges, 
card fees, and any standing order or direct 
debit payments which you have forgotten 
to include in your own records or any 
cheques written before the date of the first 
reconciliation which have only now 
appeared on your statement. 

The program then asks you for the final 
balance from your bank statement. There 
is one remaining item to complete the 
picture. It is the total value of any cash/ 
cheques that you have lodged and taken 
account of in your own cheque-book 
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Lese ‘DEBITS OUTSTANDING" 


A lp pa = nme 


Account balance 
Sees OSS 


212.79 


Statement credits mot in recs, 


Less stmt. debits not in recs, 


Adjusted cheque-bcok balance 


Da ara ed 


211.58 RECONCILED 


and would only by chance ever get them 
exactly equal. 


First attempt 


At this stage, it is quite possible that the 
program is telling you that things have not 
been reconciled! When testing this 
application out for this article, by 
pretending that I had not been keeping a 
full set of records, J got very close on the 
first attempt. The problem turned out to be 
a cheque which had been written some 
weeks before the date of the account balance 
that I had decided tostart with. This meant 


that it was not included in the cheque- 
book balance entry in cell E4. If the number 
calculated in cells E10 and E19 are different, 
the difference between them may well 
reveal what item has been omitted from 
your records, especially if it is an odd 
amountsuchasa cheque. If thereareseveral 
items, it may not be so easy; butinany case, 
if you continue keeping records, you will 
be able to achieve a full reconciliation on 
your next statement. A most unfortunate 
situation to find yourself in would be if the 
bank had actually themselves made an 
error on the statement you first tried to 
reconcile! After much head-scratching and 
frayed nerves, you might eventually 
become convinced of the usefulness of the 


program, 
Cash withdrawals 


In fairness to my present bank, I have to 
say that it has always been me that has 
been wrong and not my bank statement. 
Perhaps others have not been so well 
served! It usually comes down to a missed 
cash withdrawal such as the time the cash 
dispenser ran out of printed receipts and 
you forgot to make a note of it in your 
portable organiser! Having carefully kept 
all such receipts, I can truthfully say that, 
witha little checking, I have never failed in 
over six years to reconcile my own records 
with my bank statement. 


No need to scroll 


The program is designed insucha way as 
to make it unnecessary to scroll around the 
spreadsheet or to use the Abacus window 
facility. Once you have satisfactorily 
reconciled your records with the bank 
statement, you may save the information 
as an Abacus file in the usual way, and | 
print it out if you wish. I use a file name 
such as CHBKOCT aba to refer to my 
October cheque-book reconciliation. Once 
reconciled of course, when you come to 
use the program on your next statement, 
you can load the previous month's file and 
remove the details of those outstanding 
debits (use F3 R) that now appear on the 
latest statement and add in any new ones 
that have arisen. Then you can save the 
new information with a different name 
and delete the old file. In this way youneed 
only have one Abacus file saved on your 
disk or microdrive at any time. If you do 
wish to keep all reconciliation data files, 
then use unique filenames such as 
CHBK0190_aba for your January 1990 file, 
for example. 

In all the years I have been using this 
program, the feeling of satisfaction brought 
about by the appearance of that 
heartwarming word 'RECONCILED' on 
the screen at the end of my labours has 
been immeasurableand has given me great 
confidence in the many dealings I have 
had with my bank. I trust it may also be of 
service to you. 
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DIY 
TOOLKIT 


Simon Goodwin digs out more hidden Qdos 
extensions and reveals the most versatile DIY 
keywords yet. 


his month’s DIY Toolkit project 

introduces five new SuperBasic 

keywords: MTRAP, QTRAP, 

BTRAP, ADDOREG~ and 
DATAREG. These provide direct access 
to the hidden features of Qdos used to 
implement tasks and SuperBasic com- 
mands. 

Qdos is the collection of machine-code 
routines that give the QL its unique char- 
acter. The kernel of Qdos is built-into the 
computer, but programs and devices can 
add more, 

Qdos facilities range from simple things 
like character input and output to hard- 
disk maintenance calls undocumented in 
Qdos books or Sinclair's Technical Guide. 

Most of the facilities of Qdos are control- 
led by TRAPs — concise 68008 machine- 
code instructions that switch the proces- 
sor into ‘supervisor mode’ and divert ex- 
ecution to system software. 

TRAP #1 calls ‘manager’ routines that 
deal with the allocation of tasks, devices 
and memory. TRAP #2 can open and 
close channels, format drives and delete 
files. Once a channel is open, operations 
use TRAP #3, the ‘I/O utilisation’ trap. 

More than a hundred management and 
channel use routines are built into every 
QL or Thor rom, designed to be called 
from machine-code using TRAP instruc- 
tions. Most books on Qdos list the traps 
and their parameters; | use Andy Pennell's 
QDOS Companion and Adrian Dickens’ 
QL Advanced User Guide. Similar infor- 
mation has appeared in other books, arti- 
cles and the QL Technical Manual. 

There is not room to list all the standard 
routines here, although | shall give exam- 
ples of some that are not normally acces- 
sible from SuperBasic. The full set is tabu- 
lated, with examples, in the new DIY 
Toolkit, Volume T for Traps. 

| have planned a set of ‘general’ Qdos 
access routines for years, but deferred 

| the task while waiting for details of new 
Traps and considering the development 
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of further specialised routines. | was im- 
pressed by the Thor's |O_ TRAP keyword, 
and decided to go ahead with a DIY Toolkit 
set after comments from Lisbon’s Tiago 
Freitas Leal in letters to QL World and 
Quanta. 


Timeouts 


Tiago argued for standard Basic TRAP 
routines, pointing out that some features 
of Qdos, like timeouts, are not supported 
by existing Toolkits. “If these Toolkits did 
include extensions for all possible Qdos 
traps, they would grow beyond the eprom 
size, or take too much ram.” My general- 
ised Trap keywords need less than 400 
bytes. 


The new commands are general-pur- 
pose, and rather arcane by DIY Toolkit 
standards. The five extensions can han- 
dle atotal of 21 parameters between them 
—but sensible defaults are set so youcan 
get by with something as simple as MTRAP 
0, to read the Qdos configuration, or 
QTRAP #0, 21 to move the cursor up a 
line. 

My routines concentrate on TRAP #1 
and #3 calls. They are hidden, numerous 
and useful, while other rom routines are 
already accessible to SuperBasic pro- 
grammers. The standard CALL allows the 
use of vectors. TRAP #2 routines are well 
served by CLOSE, DELETE, FORMAT 
and many variants of OPEN, including the 
pipe commands QLINK and CONNECT, 

Qdos is an extendable system, so add- 
on programs, roms and devices can add 
extra TRAP facilities. For instance, Sin- 
clair roms lack facilities to rename or 
truncate files; these were added by Tony 


Table: Qdos late arrivals: 


TRAP #1 


. TRA 
eee 

. LTHNG 
. RTHNG 
. UTHNG 
. FTHNG 
. ZTHNG 
. NTHNG 
. STHNG 


Use a Thing 


Zap a Thing 
Next Thing 


. ROP 
. DOT 
. LINEP 
. TOPW 


. RENAME 
. RENAME 
. DATE 

. MKDIR 

. WATER 

. VERS 

. XINF 


Truncate file 


Free a Thing 


Next Thing user 


Screen raster operation 
Set points, pixel coords 
Draw lines, pixel coords 
Bring window to top 


Rename file, Al -> New name 


Set/Read file dates 
Make file into directory 
Read Thor ‘watermark’ 
Set/Read file version 
Read Drive details 


Set translate tables 
Sinclair assigned, unknown 
Link a Thing in Ram 
Remove a Thing 


tlre 
Sinclair) 
(Sinclair) 
(THOR) 


(TK2/QFLP) 
(TK2/QFLP) 
(CST/Miracle) 
(THOR) 
(THOR) 
(Miracle) 
(Rebel/Miracle) 
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Listing 1 


a get_set subq.w 
* OL WORLD DIY TOOLKIT - Direct Qdos TRAP access routines bhi.s 


* Version 0.9, Copyright 1991 Simon N Goodwin movem.1 4(al,aé.1),dO-d3/al/az 
* Is this a BTRAP? 


No: QTRAP is ready 
Warn Odos of Ab offsets 


#2,d3 
bad_param 


Tos many parameters? 


relatively tst.1 a7 
Al —> extension details bmi.s all _set 
Fetch BPLINIT ward vector trap - 


Add these extensions all_set trap #3 
lea.l regtable,a2 


movem.1 dO0-d3/ai, (a2) 
moveq #0,d0 
rte 


initialiee lea.1 define,al 
movea.w 6110\w, a? 
jmp faz) 


Find register storage area 
N.B: TRAP #3 saves At 


* 
* MIRGP TRAPI KEY C ,Di t \JobNum JC, D2? , DS, AO& AT, AL I 
* 


etrap Capa. 7 
beq.s bad_param 
mowedq #ti2,d5 


a3,aS At least one parameter? 


If not, moan at once = 


Separator bit mask! 01110000 * Functions to read register values from the REGTABLE area 
* 


and.b l(a3,a6.1),d5 Read the first separator 

Bubi.b #46,d5 Binary "\" pattern: 06110900 addres ceoms] as,a% 
* bne.« bad_param 
moveqg 16,05 
default 


No parameters expected 


Skip stored DO.L ,. D3.L 


* DI is Z if the { med) Ft et: i bad 
s Tero the fassu ret parameter separator is Continue as for DATARE® 


* bra.s 
Fetch CA.GTLIN vector 
Bet long integers 
Give up if fetch fails 
Toa many parameters? 


movea.w &116\0,a2 
ja (a2) 
boe-s 
cop. Ww #6,d03 
bhi.s bad param 
movem.1 Ofal,a&é.1),d0/d Pick up # couple jer (a2) 


tet.b Job Number parameter? bne.© bed_return 
bne.s subgq-w #i,ds 


bres bad _ param 


Save the Job Mueber in DS move. we Olal,ad.1},05 


ie tie fran ere os between 


addq.1 #2, 858 (ad) Update BYV.RIP stack pointer 
Isl.w #2,d5 DS := DS * 4 (LONG of feet? 


clriw d5 

cmpa.l ai,aS 
beq.s default 
move. wW $112\w, az 


Default = DO, report code 
bad_return No parameter? 


Bet integer parameters 


Just one parameter? 


mcower, | 
moveg - 
trap Find the system variables 
move. w Make ID from the Job Mumber 
SH. Prepare to receive the Ta 
Rett ay goure offset for long inte default lea. regtable,a2 

104(a0),d5 Add job table base offset * move. 1 (a2, 05-4) ,d0 Read stored register value 

108 (a0),.d5 Check total against the end * Make DO.L into a & byte decimal on the RI stack 

off _ job Offset beyond end of table? * 

d5,a0 Dn/An is net so orthogonal 

(a0) dS Pick up the Job base addres« 

of f_job That Job is net running! beq.s normalised 

d5, ad 0 points to the job header move.w = W20797,d4 

1Sla0),dt Copy the tag from JB. TAG add.1 d0,d0 , 

di Di = TAG;NUM = Gdos Task ID bys-= norestt sad 


Ofal,aé.1),d0 Restore fient parameter DO.L eae fate 


#16,d1 


Permit access to DO .. DS 


return fp move.w d0,d4 
move.1  d0,d5 


D4.W will be exponent 
DS.L will be mantissa 
Zero if a trivial case 
First guese at exponent 
Already normalised? 


No, halve exponent weight 
Double mantissa to match 


@lat,a6.1),d2/d3/a0/at aaveq Tey a bE Bat, shite 


O,ak 1 + iT. IPCOM 
Mele Hain ter 6 move. 1 45,40 


asl.i d1,d0 
too_far 


Take copy of mantissa 
Shift mantisse di places 


regtable, a2 Overfiows must shift leas 


dO-d3/a0, (a2) 
#0,30 


Store registers in table 


NeBe AO 2 saved by TRAP: #i dt,d4 Correct exponent for shift 


do, d5 New mantissa is more normal 
too_far . #i,di Halve shift distance 
fi. vay normalise Try shift of 8, 4, 2 and t 
pepore a eeraee ae normalised #6,d1 Six bytes please 
eee el eros SO ar t11A\w, a2 Check space with BV.CHRIX 
eport “channel not open {a2) No error return possible 
$50 (ad),al 
Report “bad parameter” 7 te ai ¥ 


a1,#56@(as) 


| 
| 
| * 
off job #-2,d0 
- bad_return 
net_open #-6,d0 
bad return 


ised «RIP 
#-15,40 Get rev: BY value 


bad_param Make room for one flaat 


bad return rts 

bai d5,2tal,ad 

* BTRAP : QTRAP # CHANNEL% , TRAPS_KEY C , Di, D2, D3, Al, AZ 7 d4, Olal,ad. 

* 4 

btrap oc ee cy Wt, a7 Addresses are inside Basic job _done aotce 
bra. traps Lau might start there: “D7#a!" = 

qtrap mW #-i,d? Indicate absolute addressing * 

traps oovea.w $1 tB\w, a2 Fetch CA.GTLIN vector * N.B: Register values DO-DS & one address, total 20 bytes, 
jer daz) Get some long integers * re-use the DEFINE table RAM space. Move REGTABLE for ROM! 
dne, 6 bad_return Give up if that fails * 
subg. 02,03 Too few? Minimum is AO , DO regtable 
bmi.s bad param Channel & Trap Key needed define 
move. ws 2(al,ab.1),d0 Get LOW word of parameter 1 
woul 940,00 
add.1 4B (ad), dO 
cmp.1 S52 (as), do 
bge.s not_open 
move. 1 Olad,dO.1),d0 Pick up the Qdos channel ID 
bmi .s not open Oops, the channel ie closed! 
move.1 dO, ad Set AO for the call 


Stack mantissa 
Stack exponent 
Floating point result 


Three procedures 


o 
o 
1 
z 


Add channel base offset 
Check it is within the table 


End of procedures 
Two functions 


orrrcrocre 


subg. w3,d3 Di, D2, D3 required? 

bpt.on get_set Yes —- so read the lot 
mavem.1 44a1,a6.1),d0-d2 

moveq Wid Default timeout ~1, forever 
bra, 6 relatively No need to eet Al or AZ 


a 
z 


End af functions 


SRF 
Bee 
tc 


| 


Tebby and others when the first disk sys- 
tems appeared, and now work on micro- 
drives too, thanks to code added by Super 
Toolkit 2 and Minerva. 

QTRAP 74 lets you re-name a file on 
floppy and hard disk. A1 should point at 
the new name. QTRAP 75 truncates a file. 
Minerva and Toolkit 2 extend the micro- 
drive handler to support these keys. 

Current roms allow Trap keys between 0 
and 127. My code passes a full long word 
so that it will work with future systems that 
may support thousands or millions of vari- 
ations. Some of the less-well-known 
TRAPs are documented in the table. 

Many readers will be interested in the 
new routines and trap numbers that have 
been added to control add-ons from Mira- 
cle, Rebel and CST/Thor. These can be 
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called with BTRAP or QTRAP, even if 
there is no new Basic command to use 
them, or you don’t want to rely on the 
command that may be provided. 


Hard disk 


Several new TRAP codes implement 
hard disk operations that are not sup- 
ported by standard Qdos. Some of these 
work with other devices, like Tony Tebby's 
revised ST drivers, but parameters and 
results vary between Rebel, Miracle and 
CST Thorimplementations, despite Chas 
Dillon's best efforts to encourage stand- 
ards. | shall explain the variations as they 
have been explained to me, and welcome 
information about changes or extensions. 


The most useful new traps are the group 
with keys between 76 and 79. Like all 
TRAP #3 routines these work on chan- 
nels, identified by an ID in AO, with extra 
parameters in data registers. 

FS DATE lets you read or set the three 
date fields in the header of a file. D2 
indicates the date concerned: 0 for up- 
date, 1 for last reference, and 2 for the 
backup date. If you only need to read the 
date, set D1 to-1; on return D1 will contain 
the date, in seconds since January 1st 
1961, to suit QL DATE functions. 

Dates have been documented, but not 
implemented, in QL file headers since the 
launch. The standard ‘GetHEAD’ trap FS. 
HEADR can read these dates, but FS. 
HEADS has never been able to set them. 

To set the current date, call FS, DATE 


DIY TOOLKIT 


Listing 2 


120 : 

150 CLS: RESTORE - 
166 PRINT “Loading Hex..." : 
176 INPOT "Save to file... 
180 SBYTES f8,start, byte ; 
190: 

200 DEFine FuNotion DECIMAL(x) 


“;£8 
STOP 


220 END DEFine DECIMAL 
230 


240 DEFine PROCedurs HEX_LOAD(start} 


290 byte = 0 ; cheoksum = 
300 REPeat load_hex_digits 


“ : EXIT load_hex_digits 


IF LEN(h$) MOD 2 


PRINT’ Odd number of hex digits in: "i 


STOP 
END IF 


FOR b = 1 TO LEN{h$) STEP 2 
lb = DECIMAL( b+41} 
IF hb<O OR hb>15 OR 1b<0 OR 1b>15 


hb = DECIMAL{b) 


PRINT’ Illegal hex digit in: “jh 


ENP IF 


POKE start+byte, 16*hb+1b 
checksum = checksum + 16¥hb + 1b 


byte = byte + 1 
END FOR b 
470 END REPeat load hex digits 
486 READ check 


with D1 zeroed. Other values of D1 are 
treated as new dates to be set. This scheme 
suits the Rebel Hard Disk and early Miracle 
drives, but current Miracle models do not 
implement the reference date; the space is 
used to store a file version number instead. 

IO. VERS takes and returns a parameter 
inD1.Zerosimply reads the version number 
for the file identified by AO; -1 reads and 
increments the number. Other values set 
the version, between 1 and 65535. 

IO. XINF reads full details of a hard drive 
into a 64 byte buffer pointed to by A1. After 
the call, with Di=0, the buffer contains the 
medium name, device name and number, 
followed by a non-zero flag byte if the drive 
is read-only. The next word indicates the 
number of bytes in each ‘allocation unit’. It 
may range from 512 bytes to 8K or more, 
depending on the system. 

The last three documented values are 
long words: the total number of allocation 
units available, the number free, and the 
length of the file header, usually 64 bytes. 
The standard FS. MDINF assumes a maxi- 
mum of 65535 512 byte sectors, but IO. 
XINF allows drives to hold far more than 32 
megabytes. 


Graphic calls 


The TRAP #3 MT. ROP is mentioned 
briefly in Sinclair's Technical Manual, along 
with some apparently unreleased pixel 
graphics calls, akin to DIY Toolkit's PLOT 
and DRAW. IT seems that these traps 
have never been implemented. Argos 6.41 
rejects them, reporting ‘bad parameter’. 

Minerva 1.64 rejects SD. DOT and SD. 
LINEP, and crashes if | call SD. ROP with 
QTRAP #2,55 — the rom jumps to $C558, 
which reads an absolute address from 
$28494 (somewhere in Screen 1, or the 
Supervisor stack), and tries to jump there. 
This causes the crash, as the address 


160 REMark Sinclair QL World HEX LOADER v 3 
116 REMark by Marcus Jeffery & Simon N Goodwin 


210 RETurn CODE(h$(x) )}-486-7#*¢(hS{x)}>"9")> 


490 IF check <> checksum 
PRINT" Checksum incorrect, Recheck data." 


500 
620 END IF 


596 DATA 378 


610 REMark Machine code data 
620 DATA “43FA014434780110"," 
“CAS3E80104050030", " 
“BE7COOOBEZ504CF1", 
“2A0170004E413205"," 
660 DATA “BAABOO6CEC2E2045", * 
670 DATA '001048412031E600", 
“E41 45PAQOE248D2", ” 
“8006 70FA600270F1", 
"S47BOL1B4ESZ66F0", 
“COFCOOZBDOAEO030", 
"Q80068BCE20405743"," 
“7F6FFBQ0A554362BE", " 
"“G@BOZ4E444E4345FA', | 
"4E75BBCB6BA07TA10". 
760 DATA “347601124E926690", " 
770 DATA “BA7?COO03626054AE", 
“203250003B8002A00" , 
"691453442A007210", 
“BAQOE24166F27206", " 
“OOSB5DES2D400056", " 
780270004E7 50003", 
“FF24054254524150", 
“Q0000002FF760744", " 
"0641444462464700", " 


630 DATA 
640 DATA 
650 DATA 


680 DATA 
680 DATA 
700 DATA 
710 DATA 
720 DATA 
730 DATA 
740 DATA 
750 DATA 


STOP 780 DATA 
790 DATA 
800 DATA 
810 DATA 
620 DATA 
830 DATA 
840 DATA 
850 DATA 


530 PRINT'Checksum correct, data entered at: 
560 END DEFine BEX_LOAD 
READ space: start=ALCHP( space) 570 


HEX_LOAD start 586 REMark Space requirements for the machine code 


: STOP 


“jatart 


4ED2BBCB67687A70" 
347601164E926458" 
“QOOSEB004A056626 " 
4841E54DDAA8 0066" 
ZALO6BZ220463228" 
"4CF1030CE8082648" 
O10F70004K7570FE" 
“4E757EO160027EFF™ 
“55436BEA303 1E602~ 
“BOAEOO346CD42036" 
6AQAACF 10007E804" 
4CF1OBOFE8044A87" 
OOTE48D2020F 7000" 
“602242 45BBCB671C" 
S5343668A3A31 E500" 
"OOSBES4D45FA0048" 


“67 1C383C081FD080" 
“2005E3A0690496-41" 
3476011A4E92226E" 
2385E8023364E600" 
“FF36055154524150" 
“FEB205 4054524150" 
41544152454 7FF64" 
0000", ?*', 32976 


($2F0063B8) is not valid. This is a strange 
bug, but hardly serious. 

MT. TRA is the equivalent of the TRA 
(TRAnslate) command in later Sinclair 
roms. The next TRAP #1 key, 37, is re- 
served by Sinclair, but | do not know why. 
Other TRAP #1 codes, documented in the 
Quanta library, are provisionally assigned 
to Tony Tebby’s long-running SMS-2 
project. The obsolete QPTR Toolkit docu- 
mentation listed a further 17 TRAP #3 
routines, with codes between 108 and 127. 

MTRAP takes between one and six pa- 
rameters. The first parameter is mandatory 
and corresponds to the ‘trap key’ — the 
value of register DO when the TRAP #1 is 
performed. This determines the operation 
performed by the trap, and is normally an 
integer between 0 and 35. 


Optional 


Five other parameters are optional, de- 
pending on the trap key and the operation 
to be performed. They are passed in data 
registers D1, D2, D3, and address regis- 
ters AO and A1. 

Many MTRAP operations deal with Qdos 
tasks, normally identified by a 32 bit ‘task 
ID’ in register D1. The !D consists of two 
integer values packed into one long word, 
which makes it fiddly to use from Basic. 

You have the option to provide just the 
task number, preceded by a backslash 
separator. In such a case, MTRAP con- 
verts the integer parameter into a task ID 
before passing it on to Qdos. For instance, 
MTRAP 9\1 release task 1. Task numbers 
are displayed by common toolkitcommands 
like JOBS and LIST_TASKS. 

| use MTRAP 9 to regain control of the 
system when | try to print having forgotten 
to connect the printer, or switch it on. At 
such times Qdos locks up the task that is 
trying to print, suspending it until the printer 
interface is ready. 


If }turn on the printer or connect the cable 
at this late stage it is likely that some 
characters will be lost or corrupted as the 
connection is made. Just as itis best to turn 
off a hose before you re-connect it, | prefer 
to release the suspended task, giving a ‘file 
I/O incomplete’ message in Quill, and try 
again later when everything is set up prop- 
erly. 


Taskforce 


This trick works with Devpac, Psion soft- 
ware, and other tasks that use Qdos to talk 
to devices. Psion users need Taskforce, or 
some similar multi-tasker, so they can is- 
sue the MTRAP command from Basic while 
the offending task is stuck. 

MTRAP can be useful when setting or 
reading Minerva’s extra MODE parameters. 
The DIY disk includes UNRESPR, | 
MINMODE and DISPLAY%, which tells | 
you which screen is being displayed. 

QTRAP takes between two and seven 
parameters. First comes a SuperBasic 
channel number, followed by an operation 
key for TRAP #3. Standard roms accept 
keys 0 to 73, with a few gaps. 

QTRAP #C%, 14 turns on the cursor in 
window C%, QTRAP #C%, 17, COL% 
moves it across to column COL%, while 
QTRAP #F%, 67, OFFSET winds the file 
pointer on channel F% back or forth by 
OFFSET bytes. 

There are lots more examples — including 
JOBLIST, EDLIN, QDOS_VER$, Minerva 
and heap,routines—in DIY Toolkit Volume 
T, one of 16 volumes of programs, exam- 
ples and text expanded from this series. 
The new volume assembler source for the 
TRAP keywords and details of all known 
Qdos calls. 

Each volume costs £3, on our branded 
disks or your microdrive cartridges, plus a 
processing charge of £4 per order. Write to 
DIY Toolkit at Cwm Gwen Hall, Pencader, 
Dyted, Cymru SA39 9HA, or call (0559) 
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DIY TOOLKIT 


Listing 3Listing 2 


632 time¥=19 : PRINT #@itimeX;' seconds >"; 
640 REMark Waits for TIME® seconds, with 50 He displays 
650 BTRAP #2, 4,8, limit®, time¥*5d, but 
PRINT “EDLIN:"!DATAREG! 
result=DATAREG 
SELect ON result 
=@ + PRINT !"No error "! 
=+1 : PRINT !"Not complete "! 
=-6 : PRINT !"Buffer full "! 


10@ REMark DIY TOOLKIT TRAP KEYWORD demonstration '* 
118 REMark BTRAP, Q@TRAP, MTRAP, DATAREG, ADDREG 
L2@ REMark Copyright Simon N Goodwin 3 May 1991 
13@ REMark Version 9.5, uses DIY Toolkit BPEEKs 


| REMark Tested on Minerva 1.64 and Argos &.41 


DEFine PROCedure JOBLIST 
| LET job=@ 
PRINT “SuperBasio verston '; VERS 

REPeat show_em 

MTRAP 2, job, 8 

JobsDATAREG{ 1) 

IF job=@ ; EXIT show_em 

PRINT “Task “, job," ig at", ADDREG! 
PRINT |" priority “!DATAREG(3) && 255 
END REPeat show_em 
END DEFine JOBLIST 


DEFine PROCedure SHOW_CURSOR( ch®) 
QTRAP fob¥, 14 
END DEFine SHOW_CURSOR 


DEFine PROCedure HIDE_CURSOR( ch®)} 
QTRAP #ah%, 15 
ui END DEFine HIDE_CURSOR 


DEFine FuNetion QDOS_VERS 
LOCal g#(4},v,4 
MTRAP @ 
@ LET v=DATAREG(2) : qg="" 
REMark Unwrap LONG into STRING 
REPeat unwrap 
wHINT( ¥/266) 
q$=CHRS(v-wk256) & g¢ 
IF ws® : EXIT unwrap 
v=" 
END REPsat unwrap 
RETurn qt 
END DEFine QDOS_VERS 


DEFine FuNotion SYSVARS 
MTRAP : RETurn ADDREG 
END DEFine SYSVARS 


DEFine PROCedure EDLIN 
LOCal buf, limit®,time%, p, result 


610 buf=BPEEK_L{@)+16 
620 limit*®=BPERK_L{8)-buf 


384 574, 1pm-9pm. 
Customised 


Existing toolkit commands are custom- 
ised for specific tasks, so they miss out 
some Qdos features in the interest of sim- 
plicity. Almost all channel traps allow a 
‘timeout’, so that the program can con- 
tinue, given an appropriate indication, if a 
device or channel remains ‘busy’ for a 
specified time. 

Qdos lets you specify a timeout when- 
ever you use a channel, but SuperBasic is 
not so generous. INKEY$ is the only stand- 
ard routine that lets you set a timeout. 
INKEY$ (100) waits until a character is 
available, or two seconds (100 frames, at 
50 frames per second) have passed. 

It might be useful to use INPUT in a 
similar way, allowing the program to con- 
tinue, using the text typed up to the dead- 
. line even if Enter was not pressed. This 
scheme is used in Di-Ren’s excellent Fleet 
Tactical Command, written in machine- 
code. Now even Basic programmers can 
use timeouts in their programs. 

The default timeout, -1, allows ‘infinite’ 
time, The Qdos scheduler continues to try 
to perform the operation until it works. 
Other possibilities range from 0 to 32767 
frames — almost 11 minutes. Timeouts 
are minima; a timeout of zero means ‘only 
do this if it can be done immediately.’ 

If a timeout of zero is used for display 
output, the action is performed at once 
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REMark Edite LENGTH bytes in SuperBasic’s buffer 

REMark {which is often used by resident procedures) 

REMark - it's wiser to use your own memory, but this 
69@ REMark illustrates how BTRAP and BPEEKs can co-exist 
603 REMark - and use « timeout, specified in seconds. 


END SELect 


PRINT !ADDREG-buf! “bytes used: ” 
REMark Echo buffer contents... 


LET p=buf 


REPeat echo 
PRINT CHRS(BPEERX(p)); 


p=pti 


IF p>=ADDREG . EXIT echo 


END REPeat. 
PRINT #3 : 
END DEFine 


DEFine PROCedure SEEK(chX, offset) 
REMark Move file pointer by +/- OFFSET 
QTRAP #ch%, 


END DEFine 


DEFine FuNotion FILEPTR(ch®} 
QTRAP #ch%, 


END DEFine 
940 : 


950 DEFine PROCedure TAB(chX, col&) 
982 @TRAP #chx%, 


97@ END DEFine 
988 : 


=REMAINDER : PRINT ! "Unexpected "! 


if still there! 


echo 
PRINT 
EDLIN 


87, offset 
SEEK 


67,@ : RETurn DATAREG(1) 
FILEPTR 


17, 001% 


990 DEFine PROCedure FOUNTS(ch®, basel, base?) 
1000 REMark Base =@ for the standard founts 
1010 QTRAP #ch%, 37,6,@,-1, basel, base2 


1820 END DEFine FOUNTS 
1830 : 


1048 DEFine PROCedure RELEASE( job%} 
1@58 MTRAP 8\ job% 
1068 END DEFine RELEASE 


1876 


1088 DEFine FuNction JOBSPACE 
1@9@ REMark Finds maximum free RAM for « task 


11@@ MTRAP 6 : 


1118 END DEFine JOBSPACE 


1128 ; 


1138 DEFine PROCedure HOLD_UP{ job®} 

114@ REMark Suspends the job indefinitely 
1188 MTRAP 8 job%, ,-1 

1169 END DEFine HOLD_UP 


1178 : 


unless CTRL-F5 has been pressed to pause 
display output, in which case Qdos returns 
with DATAREG set to -1 (not complete). A 
result of zero, ERR. OK, indicates that the 
operation went smoothly. Thus you can 
write programs that do not get stuck or 
mess up the screen with trivia when it is 
paused with CTRL-F5. 

BTRAP is a variant of QTRAP with spe- 
cial uses in SuperBasic programming. It 
lets you refer to the moving values inside 
the interpreter data area. 


Buffer 


For instance, SuperBasic uses a ‘Buffer’ 
to store temporary results, INPUT lines 
and data being copied. The Toolkit func- 
tion BPEEK_L (0) finds the offset of the 
start, and BPEEK_L (8) points past the end 
of the buffer. The exact address depends 
on the value of register A6, which points at 
the start of the SuperBasic area, and may 
change at any time. 

You can find things inside Basic with DIY 
BPEEKs, or Turbo Toolkit equivalents, but 
they are liable to move as Basic runs or 
other tasks use memory. This is no good if 
you need to pass an address to QTRAP. 

The SuperBasic interpreter makes much 
use of Qdos, so it needs to be able to use 
buffers inside its movable space. DIY 
Toolkit's BTRAP extension uses the same 
mechanism to address memory inside 


1162 REMark More in DIY TOOLKIT Volume 7 for Traps 


RETurn DATARHG( 1} 


Basic. 

BTRAP works like QTRAP but the ad- 
dress parameter is taken relative to A6, so 
that you can refer to the offset inside Basic, 
without worrying about where the inter- 
preter may have moved its tables when the 
code is executed. 

BTRAPS let you save and load data held 
inside the SuperBasic task, like array and 
string details. Be careful not to overwrite 
other things by accident. 

Display founts are not expected to move, 
once set, so you should select them with 
QTRAP rather than BTRAP. QTRAP #c%, 
37, 0, 0, -1, FOUNTO, FOUNT1 does the 
trick, assuming C% is the SuperBasic 
channel number and FOUNTO and 
FOUNT1 are absolute addresses. 

These keywords are great for experi- 
ments, as a single command will trigger 
any manager or channel use trap. The 
functions DATAREG and ADDREG let you 
check the result, error code, and values of 
all returned parameters. 


Flexible 


The code is designed to be as flexible as 
possible. It will pass any value you supply 
— sensible or otherwise — so it should 
accommodate future Qdos embellishments 
as well as Sinclair's originals and current 
extensions. 

The corollary is that the code can be 
dangerous in the wrong hands. ‘Suck it and 
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see’ programmers are at the mercy of the 
rom parameter checking. Inappropriate 
TRAPs may crash the system. 

Avoid using or releasing memory that has 
not been allocated, and don't specify odd 
addresses or negative lengths for string 
text. Qdos assumes that such parameters 
are correct — as they should be, if they 
were correctly calculated, or returned by 
one of the other TRAPs. 

It is often vital to check the error-code of 
TRAPs before assuming valid results. If an 
attempt to allocate memory has failed, you 
should not try to use the space. Often the 
error code indicates what a program should 
do next. If the cursor is already on the top 
line, QTRAP #0, 21 sets DATAREG to -4, 
signalling an ‘out of range’ error. 

DATAREG is zero after each successful 
operation; otherwise it is a Qdos error 
code. Unless the value is zero, the opera- 
tion failed and other results are not reli- 
able. 


Access 


As far as | am aware, QTRAP, MTRAP 
and BTRAP give complete access to the 
parts of Qdos previously hidden from Su- 
perBasic. The parameters and result func- 
tions have been chosen to let you set or 
read all the relevant registers. 

In general, TRAP #3 calls pass param- 
eters in registers D1 and D2, with the 
channel ID in AO and timeout in D3. Ad- 
dress parameters are passed in A1 and 
A2. DO is the error code, and other results 
are returned in D1 and A1. TRAP #1 calls 
are similar, passing data in D1, D2 and D3, 
but there is no channel ID to worry about, 
so addresses uses AO and A1. 

| MTRAP copies its fifth parameter to A3 as 
well as AO, to suit MT. IPCOM, which 
uniquely takes a single address parameter 
in A3. Other calls take two address param- 
eters in AO and A1, so A1 is the optional 
sixth parameter of MTRAP. Save your work 
before you call MT. IPCOM for the first time 
— you can easily crash the 8049, or 68008, 
or both, if you get the command sequence 
wrong. 

If several results need to be returned 
Qdos stores them in a buffer, addressed by 
Ai. A1 should point at an appropriate 
memory space, starting at an even ad- 

| dress. For instance QTRAP 0, 11, 0, 0, -1, 
BASE calls SD. CHENQ, which finds the 
window size and cursor position in charac- 
ters, and stores four words of results at 
BASE. MTRAP 24 allocates common heap 
memory. 

D1 is commonly used to return a single 
number. A few calls set D2, and MT. JINF 
returns D2 and D3, so DATAREG accepts 
an integer parameter between 0 and 3; the 
default is zero. 

ADDREG takes no parameters, as Qdos 
calls only return asingle address: AO, inthe 
case of MTRAP, or A1 for QTRAP. BTRAP 
returns Aj relative to A6, to suit BPEEK 
and its ilk. 


As usual, the keyword routines are listed 
in two forms. Listing two is a quick way to 
enter the code without using an assembler. 
The first part is the same every month. Use 
RESPR instead of ALCHP at line 150 if you 
do not own Toolkit 2. Only the DATA, from 
line 590 onwards, changes for each DIY 
project. 

The loader reads equivalent machine 
code from DATA statements, and saves 
the code in a file. Once you've loaded that 
file, as follows, you can use QTRAP, 
MTRAP, BTRAP, DATAREG and 
ADDREG in your own programs: 


base = RESPR (378) 
LBYTES “file name”, base 
CALL base 


Alternatively you can load the file directly 
with LRESPR or LINKUP. If you have al- 
ready loaded or entered the new com- 
mands on a JM or AH machine before you 
loaded the code, you need to type NEW to 
make the extensions available. 

Listing one is the corresponding assem- 
bly code program, written and assembled 
using HiSoft's DevPac. Type this text into 
your own assembler if you want to custom- 
ise the code. Note that some assemblers 
expect word vectors like $110\w to be 
entered as $110.W, or simply £110. 

The machine-code falls into three main 
chunks, wrapped around by initialisation 
code and data. The first chunk deals with 
MTRAP. It fetches long word parameters 
with CA. GTLIN, after checking the first 
parameter separator in case it is a 
backslash. 


Bad values 


If D5 is zero the second parameter is ajob 
number. TRAP treats it as an offset in the 
Qdos task table, and uses it to find the full 
task ID. Bad values cause an ‘invalid job’ 
report. 

The multiple move instruction MOVEM is 
the star of this listing. It is used to read 
several parameters from the maths stack 
at once, directly into data and address 
registers. It does no harm to pick up ‘pa- 
rameters’ that have not been supplied. 
Code to count and check parameters would 
use up ram, complicate testing, and prob- 
ably consume more processing time than it 
could save. 

If explicit values are not supplied, regis- 
ters are set to arbitrary values read from 
after the real parameters in memory. This 
does no harm, as the maths stack pointer 
BV. RIP is unmolested; in any case it is 
reset automatically when a resident pro- 
cedure finishes. Unspecified registers may 
have any value. If the parameter value 
matters, supply it. 

BTRAP and QTRAP share much the same 
code. The only difference is the TRAP #4 
performed by BTRAP, immediately before 
the main TRAP #3. TRAP #4 sets bit 7 of 
the flag JB. RELA6 in the current task 


header. The next TRAP #2 or TRAP #3 
uses this as an indication that addresses 
are relative to A6, rather than absolute. 

BTRAP and QTRAP report ‘bad param- 
eter’ if you supply too few or too many 
parameters, and ‘channel not open’ if you 
getthe first parameter wrong. Always check 
before using TRAP #4, or your code may 
abort leaving the flag set, causing bizarre 
effects when the next TRAP comes along. 

The last chunk of code implements the 
ADDREG and DATAREG functions. Both 
return long integer results converted to 
floating-point form by the familiar 
RETURN_FP normaliser. 

After each successful call the register 
values are stored in 20 bytes of memory 
are REGTABLE. The data labelled DEFINE 
is not used once the TRAP commands are 
linked to the system, so | re-use their space 
to hold the results. If you put the code in 
rom you will need to move REGTABLE to 
ram. 


Redundant? 


It might seem that DIY Toolkit is now 
redundant. Who needs further SuperBasic 
extensions, if everything is open to MTRAP, 
QTRAP and family? 

The answer is that often special-purpose 
code is faster and friendlier than a se- 
quence of TRAPs. Many programs can be 
written with a mix of Basic and TRAP calls, 
yet others —like my SET, DRAW and CLIP 
routines — add so much that is new that 
they are only practical in custom-crafted 
machine-code. 

QTRAP and MTRAP are great when 
prototyping or testing new facilities and 
interactions, or when you want to write 
code that runs independently of propri- 
etary toolkits. They shine when you need 
total control over errors and timeouts, or 
underlying routines, like FS. XINF, are not 
supported by commercial toolkits. 

DIY Toolkit TRAP commands let you get 
straight at the latest versions of Qdos, 
without waiting for Toolkit writers to catch 
up. 

| welcome your comments: applications | 
for QTRAP and MTRAP that | may have 
missed, or ideas about extensions as yet 
unavailable to SuperBasic programmers. 
Please write to me, care of QL World. 
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SECTOR 


John Shaw (and his consultancy team) venture into orbit 
in search of the killer eyeballs. 


INFORMATION 
Program: Secfor X. 256K 
memory, Minerva-compat- 
ible. 


Supplier;GCH Services, Cwm 
Gwen Hall, Pencader, Dyfed, 
Wales. SA39 YHA. 


Price: £10.00 for 3'/2 or 5! /sin 
disk (plus £1.00 p&p). £10.00 
mdv or £12.00 two mdvys (inc. 
training game) plus 10% p&p. 


ust another horizontal 
scrolling shoot-em-up 
game? 

Here are some of the best 
graphics | have seen for a long 
| time onthe QL. They must bea 
close rival to the public arcade 
machines. I am impressed. 

Idon’t profess to be an expert 
on this type of game so [left the 
main testing tothe neighbour's 
children. They found it addic- 
tive and unanimously sung its 
praises. 

The scene is set in one Lunar 
7, where evil hordes have taken 
over the five planets of the Sec- 
tor X solar system. To restore 
peace on Sector X, you have a 
ship with limited fire-power, 
and must shoot down energy 
balls to get extra weapons. 
Lastly you have to destroy the 
mothership and the evil Com- 
mand-Eye, 

This is a fast action, reflex 
testing and difficult arcade 
game. 


Training 


Fortunately the author has 
provided a training mode 
which gives you auto-immu- 
nity against most of the aliens. 
This enables you to go through 
all the scenarios enjoying the 
superb graphics. I think my 
lasting memory will be having 
a discussion with my friends, 
well into the small hours, on 
the best way to get past the evil 
spring-loaded killer eyeballs 
which wang out at you with 
unbelievable ferocity. 

You will do battle with 
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seemingly invincible snow- 
flakes, manic chess pieces and 
massive fleas. One valuable 
tactic I learned is the Harrier 
pilots’ ‘up and over’ manoeu- 
vre which seems to be the only 
way to kill creatures which 
appear behind you. 

This is anarcade game, which 
should provide many, many 
hours of lasting pleasure; I 
recommend it without reser- 
vation. 


CLUB MEETING 


nearea of theOLscene 
which has previously 
escaped investigation 
by many QL users is 
that of local computer clubs. 
Quanta, the QL User Group, 
has approximately twenty clubs 
or ‘sub-groups’, dotted in many 
places both in Britain and on the 
Continent, where Quanta 
members and non-members 
meet normally on a monthly 
basis. This is a report from the 
March meeting of a typical sub- 
group QMAS (Quanta Mid- 
Anglia), which holds its meet- 
ings on the second Monday 
evening of every month in a 
small church hall in Lolworth, a 
village just outside Cambridge. 

TheQMAS Clubis fairly small, 
attracting each month about 
twenty-five members with 
varying skills, from those who 
have just mastered Quill to one 
member who designed parts of 
the OL. 


This diversity of membership 
ensures that a new member is 
bound to find people of similar 

ability and there are always 
peopleata meeting tolearnnew 
things from and to answer any 
questions and solve any prob- 
lems whicha QL user is likely to 
encounter, from changing a 
keyboard membrane and get- 
| ting a pound sign to print out, to 
learning a new computer lan- 
guage. Typical meetings are 
usually very busy, with many 
separate activities and discus- 
sions occurring simultaneously, 
and if the discussions go over 
your head, there is always the 
coffee and biscuits to resort to! 

March's meeting was very ac- 
tive, with many new develop- 
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ments in OL software and hard- 
ware being shown for the first 
time. 

One piece of new software, 
the beta-test version of Digital 
Precision's Perfection, was being 
shown by one of the members 
at the Club, and it was clear that 
it is a very fast word processor 
indeed. Using whatis knownas 
a ‘lazy screen’ to speed up the 
cursor key movement, it also 
has full WYSIWYG (what you 
see is what you get), although 
my first impressions suggested 
that it is not as powerful in this 
one respect at text87. Having 
said that, users who find text87 
difficult to get to grips with will 
probably find Perfection a god- 
send. 

One of the members, Terry 
Harman, has developed a plug- 
in eprom board for the QL. An 


One user's home-boxed QL set-up. 


eprom (erasable programmable 
read only memory) is, as its 
name suggests, a type of com- 
puter memory that can, once 
written to with an eprom pro- 
grammer, keep is contents even 
when the computer's power is 
switched off, until it is erased 
using a special ultra-violet 
eraser. Thismakesit very useful 
tocomputer users, because they 
can store their most commonly 
used programs and resident 
extensions intheeproms, which 
will then run as soon as the 
computer is switched on, with- 
out taking up valuable ram 
space. 

Terry Harman's board, which 
can contain up to 192KB of pro- 
gram code in eproms, simply 


QUANTA IN EAST ANGLIA 


Local groups dedicated to the QL are 
flourishing. Carl Watson reports. 


A discussion amongst the club members. 


slips into the expansion port on 
the QL's left side. For users 
withoutaneprom programmer, 
Mr Harman is willing to blow’ 
the eproms, with their chosen 
software on board, for them 
using QEP3. Unfortunately this 
device is not compatible with 
Miracle System's Trump Card, 
because that takes all the avail- 
able memory space, leaving 
none for the eprom board, but it 
should nevertheless prove use- 
ful to a large number of QL 
owners. 
Home boxed QLs were much 
in evidence at the March meet- 
ing. Onemember, Steve Bourne, 
has gone so far as to box his OL 
in an IBM personal computer 
case, complete with IBM key- 
board (connected via a suitable 
interface), and three floppy 
drives. Another member used 
theoriginal keyboard connected 
via a home-made extension ca- 
blecomplete with stickers above 


Jonathan Oakley of QView, with his robot. 


the microdrives to show all his 
Toolkit 2 ‘altkeys' and ‘hotkeys’, 
avery useful idea and one which 
I think | shall use myself. Yet 


another has his QL in a box, 
interfaced to two 10-megabyte 
hard disks. That particular size 
of hard disk is toosmall for PCs, 
because their programs are 
much larger than the QLs, butis 
perfect for the QL and can be 
purchased quite cheaply second 
hand. 

There is quite a lot of interest 
in the Mandelbrot Set and other 
related fractals at QMAS, with 
members regularly bringing 
along new and faster programs. 
One member, Carl Cronin, has 
developed a Mandelbrot pro- 
gram that, instead of plotting 
the MandelbrotSeton thescreen 
as most programs do, prints it 
in eight colours on a Star LC10c 
printer. Using this technique full 
size Ad page Mandelbrots, with 
resolutions of 960 by 792 pixels 
can be generated and this 
method certainly lends itself to 
producing spectacular graph- 
ics. This program is public do- 
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main. It is available from CGH 
Services and inthe near futureit 
will be in the Quanta library. 

QView, the developers of 
Minerva, are members of 
QMAS and had an exciting 
new development for QL users 
which they demonstrated. 
Having persuaded many QL 
users to rip the top off their 
machine and replace the na- 
tive Sinclair JS, JM or even AH 
Qdos operating system with 
their derivative of it, Minerva, 
they have now developed an 
eeprom board. An eeprom 
{electrically crasable pro- 
grammable read only 
memory) is similar to both a 
ram chip and the eprom chip 
explained earlier. Like an 
eprom, an eeprom can have 
data stored in it, which will 
remain even if the power is 
removed, butitdoes not need to 
be blown using a special eprom 
programmer; the QL can actu- 
ally blow the chip itself. 


Eeprom 


The QView eeprom board, 
which sits in one of the rom 
sockets inside the OL, contains 
255 bytes of eeprom and a real 


32 Hunts Pond Road 
All Programs for 768K E 
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The QView eeprom board, inside the QL. 


time clock, and comes complete 
with Minerva version 1.88. The 
eeprom is used to hold the de- 
fault settings for the OL, so that 
it remembers whether to boot 
into screen mode 4 or 8 when 
being switched on, and itknows 
which device to boot off. Lots of 
other useful pieces of informa- 
tion can be stored, such as a 
message from the user that will 
appear on the QL’'s screen be- 
fore Fl is pressed, when it is 
switched on, or default settings 
for a word processor, or a pass- 
word, to give some examples. 
Jonathan Oakley, amember of 
OView and an ex-Sinclair em- 
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SPEEDSORT 
The ultimate sorter! Sorts arrays of any size by given 
element number. The speed is devastating — up to 80,000 
sorts per second! 


Machine Code 


£20.00 


ark Gate — Southampton - 


ployee, spent much of the 
evening demonstrating a new 
method he has developed of 
controlling robots and other 
similar devices from theQL. The 
eeprom device also has a sys 
tem bus, which can be utilised, 
using a short piece of 
SuperBASIC and a small cir- 
cuit, by would-be robot devel- 
opers to send signals to their 
robot. Jonathan himself was 
using the bus to control an arm 
robot which was solving the 
Tower of Hanoi puzzle. 

The QMAS Club itself has 
many resources available for 
loan to members, including the 


d QL with Trumpcard 


SO3 6QA — 0489 581056 


complete Quanta program li- 
brary consisting of over forty 
disks and a backup QL, for 
emergencies when a member's 
QOL breaks down. The Club 
Chairman Peter Rowell is also 
thinking of purchasing, using 
Club funds, a ribbon re-inking 
machine, to allow members to 
re-ink their printer ribbons for 
as little as 50p. 


Meetings 


As L said at the beginning of 
this article, there are many OL 
clubs all round the country 
waiting for new members to 
drop in. Having been to a 
number of these meetings, I can 
say that they are very worth- 
while, It is certainly worth get- 
ting in touch with the secretary 
of Quanta toseeif there isa club 
near you. You don't have tobea 
member of Quanta to go along 
and Iam sure that you too will 
find much of interest waiting 
for you. 

For details of QUANTA sub- 
groups and workshops, contact 
the Quanta General Secretary, 
Ron Durret, 38 Brunwin Road, 
Rayne, Braintree, Essex, CM7 
SBU. 


QLDL 


QL Disk Library allows the user to catalogue up to 3000 
program titles (around 75 disks at a time) in alphabetical order 
and cross-referenced by numbers given to the disks. No more 

searching for endless hours for that lost program. 


Machine Code 


SCREENMASTER 


Screenmaster will record anything currently on screen in a 
‘squeezed’ form, and reproduce the picture in a variety of 
cinematographic-style wipes and speeds. 


Machine Code 


PLANNER 


One of the most useful programs you could wish for. It will provide a printout of 
dates, with day and week numbers, in a month-per-page format from a given 
starting date and number of forward days, It also includes routines for finding 

day and week numbers you can use in your own programs. 


Machine Code 


£10.00 


ALL PROGRAMS SUPPLIED 
Sinclair/QL World July 1991 _ 


£20.00 


£15.00 


TRANQUIL 
Tranquil converts Quill documents into BASIC PRINT 
statement form in order that they can be more easily 
manipulated for printing and adding prinier instructions etc. 
Machine Code £10.00 


2INCH DISKS — POSTAGE & PACKING FREE 
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INFORMATION 


Price: 
overseas orders) 


222 The Avenue, 
Chingford, 
London E4 9SE. 


esktop publishing is 

a good area for de- 

velopers of utilities. 

The print trade uses 
a vast quantity of typefaces 
and enhancements, shapes, 
pictures, colours etc., and it is 
unlikely any dtp program will 
provide the serious user with 
more than his/her basic re- 
quirements when it is first in- 
troduced. Digital Precision's 
Professional Publisher is by no 
means in its first version, hav- 
ing been developed from their 
first essay into dtp — Desktop 
Publisher — and having had a 
variety ofimprovements made 
since its introduction (for ex- 
ample, the much quicker load- 
ing process of the latest ver- 
sion). 


Defined 


Comprehensive as ProPubis, 
there are several ways in which 
a developer can extend its 
range, perhaps the most obvi- 
ous one being the provision of 
better-defined characters, 
particularly in large sizes. 
DeLuxe Font Enlarger (also from 
DP) deals with this area, but 
Professional Publisher Toolbox 
goes a bit further. It supplies 
additional QLS (standard) and 
HDF (high-definition) founts, 
and also provides tools for im- 
proving text format, import- 
ing non-DP clip art, and sav- 
ing ProPub pages as screens 
which can be loaded into 
graphics programs. 

The Toolbox is supplied only 
on disk, is for systems with at 
least 256 KB ram (ProPub itself 
needs this much), and is suit- 
able for Thors, including the 
XVI. The supplied disk con- 
tained no less than 92 files — 36 
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Program: Professional Publisher Toolbox 
£29,95 (plus 5/10% for 


Supplier: Digital Precision Ltd., 


Tel: (081)-527-5493 


QLS founts, 44 HDF founts, 
six screens, one page, a boot, 
three utility programs, and an 
Xtras extensions file. The boot 
is there solely to load the ex- 
tensions file and will not be 
necessary if the user already 
has an appropriate version of 
DPs Xtras file (or equivalent) 
loaded for use with another 
program (eg The Editor, text 87, 
Perfection), to obtain the de- 
sired layout (text files loaded 
directly into ProPub may lose 
their paragraph splits, for in- 
stance). 

The only instructions sup- 
plied with the view disk were 
ona single sheet of paper. The 
brevity of the information 
should not be a handicap for 


re FIWARE FILE 


PROFESSIONAL 
PUBLISHER 
TOOLBOX 


Bryan Davies samples a new support bundle for the 
popular DP desktop publishing package. 


experienced users; it is fairly 
obvious how to use the utili- 
ties once they have been EXEC- 
ed, and founts are simply 
loaded into ProPub in the nor- 
mal way. 

Preptext removes some 
oddities that can appear when 
Ascii text files are loaded into 
ProPub. Linefeeds are replaced 
by spaces, and nulls—CHR$(0) 
— are then replaced by 
linefeeds, The effect is best il- 
lustrated by example, and the 
first illustration is of a text file 
Export-ed from Perfection and 
loaded directly into ProPub 
with the Configuration and 
Line Feed settings at 
WordWrap and Included, re- 
spectively. Note the ‘half-lines' 


An imported file, pre-Preptext. 


All the tne 

you are thinking about the 

oi other people are 
vering amay, 

doing the same thing. Worse 

still, they may introduce their 

“baby* 


better than ones you have 
aritten. Portunataly 
for QL programmers, there is 


distinct possibility that 
Further refinements of text87 


mould 

(the Dooklet & Laserdet 

teeing for example). 
problea sae 


teat; 


gore one of deciding 
what features aere nected to 


it ie to find ond fix 
problems. Although the 
there may be no-one ose 
uriting a WP progran to 
compete aith you, there 
moy be someone uriting 


for several of DP.'s existing 
programe. A lose-likely 
occurrence is the 


did aoa itself during beta 


ing 

Perfection. Fortunately, one 
of the Minerva developers 
was aaare of the 

difference betwoen IN and JS 


va 


The same file, post-Preptext. 


Developing o attract exist Developing « added, the grener becomes 
word-processing program is | users, and of word-processing program is the testing requirement. and 
no mean undartebi incorporating them into a no pean un ing. Many the harder it i@ to find and 
Nany people start on the program of le pega start on the task —- fix problems, Although there 
task ~~ and soon abandon it, size. The more fenturas are ni soon abandon i, Even a may be no-one eles uriting « 

Even a “simple” added, the greater becomes simple” program like Quill Program to compete with 
program like Quill required a the testing required a angsive you, there may be someone 
massive programming effort. requirement, and the harder programming effort, All the  ariting another rem that 


another rem thet will ours, and theire say have discovery of an “unknoun” 
before you are ready with couse sees coaflict Sohal you hadn't thought feature of one of the Sinclair 
ours, and theirs may have ath yours. A good exampla of, or ahich work better QD0S versions: by nou, 
‘atures you hadn't is the Minerva ROH, hic! than ones you have aritten. most of the of AH, 
thought of, or ahich work hae caused Fortunately for GQ = IM. JS otc hay: 


little competition, it discovery of an “unknown” out with a good Fortunately, one of the 

was unlikely that anyone else feature of one of the Sinclair mord-processing progras Minerva developers woo aware 
would come out with a good vareisaa! whilst Pecfection was of the difference betwean JM 
word: processing by ‘om, wost of tha iodibalss developed, although there mas and JS ROM versions hich 
program siiel Pocfection wie: WF AM BUTT Ge tee a distinct poseibility that Cagle ext thie particular 
being developed. although  { bly) been further ts of textB7? pro! and mas able to 
thace ‘san dicoverst har ansdiec aaa would appear (the DeckJot & point DP. in the right 


programmers, there ts little 
competition. lt mae unlikely 
that anyone else mould come 


LaserJet printer-drivers, for 
exeaple). The problem ans 
more one of deciding upon 
features were needed to 
attract exbsting Quill 
and of incorporating them 


and lack of paragraphs. The 
second illustration shows the 
same file loaded, with the same 
settings, after it had been proc- 
essed by Preptext. The text 
format is now more sensible. 
As an incidental feature, this 
utility can be used on files from 
The Editor or Perfection be- 
fore they are Imported into 
Quill, in the 'by paragraph’ 
mode. 

The Grab Sector Clip Art 
utility does what you would 
expect. It loads one of the Sec- } 
tor Software clip art files (de- 
signed to be used with Page 
Designer) to the screen and 
converts it into a form suitable 
for loading into Professional 
Publisher; that is, into a 32 KB 


into a 
size, 


ram of acceptable 
more features are 


ail — ws con . ig 
yours. ood exagple is 
Minecve, fou which hae 
caused hiccups for several of 
D.P.'s exiting programs. A 
less-likely occurrence is the 


dement 
been ered, but another 
beta testing of Perfection, 


direction (and thereby 
sonvuha mollify DP, after 
the aggravation over 
conflicts aith Minerval) Users 
way differ on what is the 
biggest drauback of Guill, 


users, 


Sinclair/QL World July 1991 


PRO PUB TOOLBOX 


Some Sector 
clip art 
grabbed and 
imported. 


SBYTES file. The conversion is 
done quickly, with the on- 
screen prompts being suffi- 
cient explanation of what to 
do. The routine is less than 
helpful when the first conver- 
sion has been completed — it 
simply writes ‘Done.’ to the 


screen, and leaves the user with , 


no cursor, and no suggestions 
as to what to do next. Pressing 
ENTER achieves nothing ap- 
parent, and it seems necessary 
to return to SuperBasic and 
restart the routine. It is also 
necessary to do a separate SB 
directory of the input device, 
and list the required files 


Illustrations combined from two sources. 


o1NC 


LAIR 
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manually, since there is no di- 
rectory function built-into the 
Grab routine itself. Not very 
helpful if you want to convert 
a few dozen files. The third 
illustration shows some Sec- 
tor clip art, converted by Grab 
and loaded onto a ProPub 
page. 

The Screen From Page rou- 
tine will take part of an exist- 
ing Professional Publisher 
page and save it as a screen 
(picture), in the form of a 32 
KB SBYTES file. This allows 
that part of the screen to be 
loaded into a graphics pro- 
gram and modified; it can sub- 
sequently be reloaded into 
ProPub. The routine does not 
itself allow selection of part 
of a page — that has to be 
done in ProPub, by identify- 
ing the page section required 
there and saving it as a part- 
page. 


Surplus 


Alternatively, you canuse the 
whole page, and allow the 
routine to deal with just the 
top, left part of it, assuming 
what you want is contained 
within that area. Any surplus 
material can be removed later, 
using a graphics program or 
ProPub. The Screen routine 
converts all of the chosen area 
into a 32 KB screen file. It 
doesn’t care whether the page 
section concerned is graphics 
or text. The fourth illustration 
is of a combination of parts of 
two ProPub pages. The top 
section (the portrait) comes 
from one of Digital Precision's 
sample page files, and is actu- 
ally a drawing done with the 
graphics program Eye-Q and 
imported into ProPub. The 
bottom section comes from a 
page created during the course 
of writing an article on using 


ProPub, and is the top left- 
hand corner of a reproduction 
of the front cover of QL World, 
created directly with ProPub. 
The two parts of the illustra- 
tion were converted separately 
with the Screen routine, then 
loaded asSBYTES pictures into 
ProPub, and printed from 
there, in a three-pass print of 
the resulting page on a nine- 
pin printer. This routine, also, 
ends one conversion operation 
with the message 'Done.', and 
you appear to have to restart 
the routine to convert another 
file; likewise, you need todoa 
directory beforehand, toknow 
what file name you need for 
input. 


and this is the SHARPL fount, 
Both of them are supplied on 
the PROPUB TOOLBOX disk, 


Two font samples 


There are too many addi- 
tional founts on the Toolbox 
disk to do more than show a 
couple of samples here. A total 
of 36 QLS and 44 HDF (high- 
definition) founts are supplied; 
two of the latter are shown in 
the fifth illustration. The space 
taken by these founts varies 
quite a bit, and the user may 
have to remove several of the 
default founts to get certain 
new ones in. For example, the 
STONEWORKS_HDF fountis 
in a file of 16 KB, which is 
much larger than most of the 
other founts. 

The three routines, and the 
founts, on the disk do their job 
well. They are all useful acces- 
sories for the Professional 
Publisher user. The less-expe- 
rienced user would welcome 
more written advice on how to 
make use of the functions, or 
integration of the routines with 
ProPub itself, but it is fairly 
usual with such add-ons for 
them to be rather spartan in 
this respect. The results speak 
for themselves, as shown in 
the illustrations here. The user 
gains significant flexibility, 
without losing much time, and 
the cost is modest. 
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LEARN TO LOVE YOUR PRINTER 


Leam to 
Love Your 


he first part of this article gave 

comments on making the basic 

entries in the table displayed by 

the Quill Install_bas program. 
Those are the entries which are relatively 
fixed, regardless of printer. This final part 
deals with the table entries which can be 
used to good effect to control your par- 
ticular printer. 

The Preamble and Postamble code set- 
tings hold the basic design of your sheet 
of printed paper; if any particular printer 
feature is going to be needed throughout 
printing, it should be called in the Pre- 
amble. For example, if you normally print 
in 12-pitch, switch that feature on with 
the Preamble. This doesn’t stop you 
changing to any other pitch within a 
document, but you know that the printer 
will always start in 12-pitch mode. Like- 
wise, if you normally use the USA 
standard character set, switch it on with 
the Preamble. The Postamble enables you 
to switch the printer back to some basic 
setting, when a print run has finished. 
You then know what itis going to be set to 
do when you next use it (assuming it has 
not been switched off); this is essential if 
you print from different sources — for 
example, Quill and SuperBasic — during 
one session, as it avoids the messy effect 
that the different source formats can 
produce. For example, if you end up a 
Quill document with condensed print, 
and then go on to list a SB program, the 
printer is not to know you don’t still want 
condensed print, if you don’t tell it so. 


Entering Codes 


All the entries from Preamble on down 
require a particular form of presentation, 
to meet the requirements of Install_bas. 
You have a choice of four ways of enter- 
ing the character codes, but it may be that 
neither of these ways is exactly the same 
as that in which the codes are set out in 
your printer manual. Nevertheless, you 
must use the Quill way. 
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Codes have to be entered singly, sepa- 
rated by commas, with a maximum of 10 
codes per entry. It is acceptable to mix the 
code types ona line. The types are: Ascii 
mnemonics, such as ESC, NUL, SOH; 
hexadecimal codes between $0 and $FF; 
decimal codes between 0 and 225; single 
characters preceded by a single or double 
quote mark, eg “I, 1, “4. For example, my 
printer manual states that the coding for 
setting Elite typestyle (12-pitch) is ESC 
"M”, <1 B>y<4D>y, or <27>19<77>109; this 

can be entered as ESC.”M, or 27,77, or 
1B,4D, or ESC,77, or 27,4D, or any other 
similar combination. 

Returning to the Preamble sequence, it 
can be used to switch on alternative/ 
extra character sets (you may want Greek, 
Spanish or other language symbols), mar- 
gins, tab intervals etc. 

The Postamble may not be needed, but 
a typical sequence is ESC,”@ to return the 
printer to the same settings as when it is 
first switched on. The Bold, Underline, 
Subscript and Superscript on/off entries 
are for the embedded Quill typestyle 
functions —those you can obtain using the 
F4 key. The entries are the codes your 
printer expects to see for the correspond- 
ing functions, suchas ESC,”G for double- 
strike printing, which is a form of Bold 
print. 

Check the descriptions of function ac- 
tions carefully before using them; some 
functions do not work with others, a typi- 
cal case being that emphasized print 
(another form of Bold) may not work with 
the Elite character size. Subscript and 
Superscript are functions which many 
users wil] never use and they can be con- 
verted to other functions. There is nothing 
to stop you inserting the printer codes for, 
say, italic print into the Subscript entry; 
then, whenever you use F4 L, you will get 
italic print. The screen presentation will 
still be the stylised, raised characters, 
however. 

Many printers have more useful func- 
tions than the Quill printer driver can 


Part Two 


Bryan Davies 
surveys Quill 
commands to get 
the best from your 
printer. 


command, and adding another two pos- 
sibilities may be sufficient to solve a di- 
lemma. The 10 Translate entries differ 
from the four embedded command en- 
tries in that you have to insert both the 
codes for the command keying and those 
for the corresponding printer function. 
This means that you have a maximum of 
nine codes left to describe to the printer 
what is required when one key is hit. 

There may be more than one way of 
getting a particular printer function, and 
it can be necessary to look for the shortest 
coding. The first code is the one produced 
by the keyboard, and it must be in the 
range decimal 32 to 255. This limits you to 
using keyings that produce characters on 
the screen, which is desirable in that you 
have some indication of changes in print 
form. 

If, like me, you want to keep keypresses 
to a minimum, you have to look at the 
keyboard and decide which characters 
shown there are not likely to be used 
within text; ~,@,: are examples which can 
be produced using two keys, and you 
may be able to do without one-key char- 
acters such as \, [, ]. There is a wider 
choice if you accept three keys per char- 
acter. All possibilities are listed in the 
‘character set and keys’ section of the QL 
User Guide, and it is from there that you 
can get the corresponding codes to enter 
into the printer driver. 


Sample table 


A sample printer driver table is given 
here, for guidance only. The printer con- 
cerned is ‘Epson-compatible’, but that 
doesn’t mean the codes are just the same 
as onan Epson. Look at this table forideas 
on how to tackle producing your own 
particular requirements. Note that the 
Translates can be used both to switch on 
printer functions and to convert character 
codes from those used by the keyboard to 
those required by the printer for the same 
characters. The obvious example of the 
latter is the £ sign, so often printed out as 
something else. The QL keyboard code 
for this character is decimal 96; the same 
code produces a single quotation mark on 
the Kaga printer, with either the USA or 
the UK character set. To be able to print 
the# character, the USA set can be used; to 
get the £ as well (without using the code 
35 needed for the #), an additional charac 
ter set has to be activated. 

The code 6 in the additional set on the 
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Kaga produces the £, so the Translate 
entry is simply 96,6. Here, the additional 
character set is switched on with the Pre- 
amble, but it could be switched on by the 
Translate 96,ESC,I,SOH,6. Each Translate 
entry can be used to produce only one 
printed character; it doesn’t matter how 
many codes (up tonine) are used tospecify 
that character, however. This is used in 
producing the @ character; CTRL-SHIFT- 
R puts it onto the screen, and to get it 
printed the Danish character set isinvoked 
(for this one character only). 

The Translate entry is 
178,27,82,4,92,27,82,0 whichis the QL code 
for @ (178), followed by switching on the 
Danish set, followed by the Kaga code \ 
(92), then switching off the Danish set. 

There are some points to remember 
when calling up typestyles. If you want to 
use several pitches, and features like 
proportional spacing, you have to ensure 
that switching off a feature returns the 
printer toa suitable state for what it has to 
donext. NLO printis 10-pitch and, if your 
basic typestyle is 12-pitch, you have to 
switch off NLO by telling the printer to 
switch to 12-pitch. The same applies to 
enlarged (and enlarged-condensed) Pica. 

In the sample driver, the Preamble sets 
12-pitch as the basic style (ESC,”M). NLQ 
is called by the * character (code 94), and 
switched off by calling Elite (12-pitch) 
again, hence Translate 2 reads 
“,ESC,GESC,p,SOH. Note here that you 
cannot type in * when entering this line— 
Quill wants the code itself. ESC,p,SOH is 
one way of specifying 12-pitch, and 
ESC,"M works just as well. Proportional 
spacing may work only with 10-pitch, 
and has to be switched off deliberately 
when 12-pitch is returned to. 

One easy trap to fall intois the one set by 
the printer makers when using three or 
more codes for a function. The third code 
may beshownassimply n, and it might be 
less than obvious what form this has to 
take — decimal, straight numeric, etc. 
Where NUL or SOH appear in the sample 
driver, you have examples of n being set 
to 0 or 1. The actual entry typed in to 
produce the screen entry ESC,R,NUL was 
27 82,0. On the other hand, the ESC “!" +n 
function has a list of 64 typestyles (on the 
Kaga) and they cannot be entered by us- 
ing the numbers 0-63 as Ascii codes (that 
is after a quotation mark); to set bold, 
enlarged-condensed Pica, you can enter 
ESC,!,"4, or 27,33,52 ete. 52 is the listed 
decimal number, 4 is the equivalent Ascii 
character (that appears on thescreen when 
you hit the 4 key). 

The decimal number is arrived at by 
looking at a table of (computer) bit set- 
tings, and selecting the features required; 
in this case enlarged print requires the 
fifth bit to be set ‘on’, double-strike (bold) 
requires the fourth bit to beon, condensed 
requires the second bit to be on. This 
means that the decimal code (the sum of 
the bit settings) is 1x 25+1x24+1x22= 
52. The combination of enlarged and con- 
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densed Pica give 8.55 characters/inch, a 
useful medium-size print for headings. 

The purpose of Translate 7 may not be 
obvious. In order to maximize the avail- 
able Translate entries, this one setting is 
used to switch off any or all of the others. 
By doing this, you don’t have to use two 
entries for each function, one each to 
switch it on and off. Translate 7 sets the 
print style back to Elite (12-pitch), turns 
pr oportional spacing off, and turns italics 
off. 


Turn off and on 


Using this approach, you have to re- 
member that the ‘off’ keying will turn off 
features you may want to continue using, 
and it may be necessary to turn them back 
on immediately afterwards. If you have 
chosen to have both condensed and italics 
on, together, then to switch off only the 
italics, the ‘off’ switch puts both italics 
and condensed out of action, and you 
have to reset condensed. This situation 
should not occur frequently, and the need 
to reset a feature occasionally is a small 
price to pay for the ability to have several 
more Translate entries available, and for 
not having to remember a variety of dif- 
ferent keys for switching features off. Of 
course, however you look at it, having to 
use ‘odd’ symbols and key combinations 
to select printer features is far from being 
the ideal way of making the features easy 
to use, but we have to live within the 
constraints imposed upon us by the soft- 
ware and hardware designers. | much 
prefer to use mnemonic keying, but that 
really isn’t feasible with the basic Quill; 
when dealing with The Editor later, | will 
explain how more-recognisable key com- 
binations can be set up to call the features. 

It is surprising that, when Quill was re- 


written for use on PCs, the number of 
embedded feature-calls was notincreased 
much; the only additional feature avail- 
able is italic print, but even that puts Quill 
well ahead of many programs costing 
several hundred pounds. For those using 
botha PC and a QL~ maybe the former in 
the office, and the latter at home — it is 
quite straightforward toset the respective 
printer drivers up to use essentially the 
same key combinations on both machines, 
with only minor variations to allow for 
the different way italics have to be called 
and for keyboard variations. 

Asample printer driver for Kaga-Taxan 
KP-810 (Canon PW'1080A) printer follows. 
The basic setting, from the Preamble en- 
try, is Elite (12-pitch) type on, Printable 
Control Code range on, Printable Range 
Expansion on. The embedded Quill fea- 
tures F4 B/U/H/T. are set to give those 
features — Bold /Underlined /Super- 
script/ Subscript. The Translate entries 1- 
10 call these features: 


(1) proportional Pica (0-pitch; propor- 

tional spacing is alwavs bold), 

(2) sgh aba nlq (bold and 10- pitch), 

(3) enlarged, proportional Pica (bold, 5- 

pitch), 

(4) condensed Pica (17.14-pitch), 

(5) enlarged-condensed bold Pica 
(8.53-pitch), 

(6) enlarged, bold Elite (6-pitch), 

(7) italics and proportional spacing off, 
Elite on Veverything off’), 

(8) convert keyboard £ to printer £ 

(9) italics on, 

(10) convert keyboard © to printer ©. 


Ina few cases, combinations of calling 
codes may not produce the desired result 
unless they are in a certain order; in the 
examples given here, itis necessary to key 
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Screen display: 


NAME 
PORT 
BAUD RATE 


PARITY 


LINES/PAGE 
CHARACTERS /LINE 
CONTINUOUS FORMS 
END OF LINE CODE 
PREAMBLE CODE 
POSTAMBLE CODE 
BOLD ON 

BOLD OFF 
UNDERLINE ON 
UNDERLINE OFF 
SUBSCRIPT ON 
SUBSCRIPT OFF 
SUPERSCRIPT ON 
SUPERSCRIPT OFF 
TRANSLATE 1 
TRANSLATE 2 
TRANSLATE 3 
TRANSLATE 4 
TRANSLATE 5 
TRANSLATE 6 
TRANSLATE 7 


134 
NO 
CR,LF 


ESC,@ 
ESC,G 
ESC,H 
ESC,--SOH 
ESC,-,NUL 
ESC,S,SOH 
ESC,T 
ESC,S,NUL 
ESC,T 


{,ESC,!,EOT 
LESC,!,4 
~ESC,!,1 


ESC,p,NUL 
£,ACK 
\,ESC,4 


TRANSLATE 8 

TRANSLATE 9 

TRANSLATE 10 
NUL 


:“, rather than “:, to get enlarged propor- 
tional nlq. 

Reverting back to the point about non- 
printing codes spoiling the line justifica- 
tion, one way of partially fixing the prob- 
lem is to insert a space (or two) into the 
Translate entries concerned. Take italics in 
the sample above; as it stands, putting the 
character \ into a document will cause the 
printer to use italic type, and to shorten the 
line it is on.by one space for every occur- 
rence of the \. If the code conversion for 
switching off all codes is changed to 
127,27,53,27,33,1,27,112,0,32, a space will 
be ‘printed’ each time any of the typestyle 
codes is switched off. The print begins to 
look rather strange if you insert more than 
one space each time, however, so that it is 
not feasible to balance out all codes. 


Flexability 


To Create a Driver_dat file for The Edi- 
tor, the process is essentially similar to that 
with Printer_datin Quill, but thereis much 
more flexibility to choose what you want 
to do with the printer. The greater range of 
possibilities offered does entail doing more 
thinking, if you are to really use the fea- 
tures, but you can make a minimal file 
without great effort. It is helpful to have 
gone through all the agonies with Quill 
beforehand — not that this will necessarily 


ESC,M,ESC,I,SOH,ESC,6 


Comments/decimal code 
keying: 

(10 characters maximum) 
(only alternative is SER2) 
(or 75/300/600/1200/ 
2400/4800) 
(orSPACE/MARK/ODD/ 
EVEN) 

(0 to 255) 

(0 to 255) 

(or YES) 


27,77 ,27,73,1,27,54 
27,64 

27,71 

27,72 

27,45,1 

27,45,0 

27,83,1 

27,84 

27,83,0 

27,84 


@,ESC,|NUL,ESC,p,SOH 64,27,33,0,27,112,1 
A ESC,(ESC,p,SOH 
| ESC,!,0,ESC,p,SOH 


94,27,40,27,112,1 
124,27,33,48,27,112,1 
123,27,33,4 
125,27,33,52 
126,27,33,49 


©,ESC,5,ESC,!,SOH, 


127,27,53,27,33,1,27,112,0 
96,6 
92,27,52 


@,ESC,R,EOT,\,ESC,R, 


178,27 ,82,4,92,27,82,0 


prevent you making the same boobs! The 
file can be created in The Editor itself, and 
there is a sample file to give guidance. The 
manual goes into much more detail than 
the OL User Guide, and the comment here 
is on only those points where I had trouble. 

Itis possible to make the keying compat- 
ible with that used in Quill, but it is likely 
you will end up not doing this, for various 
reasons. Now you have the opportunity to 
use control codes which do not involve 
‘losing’ normal keyboard characters, you 
may choose to do so. Being able to call 
more printer features means finding more 
key combinations, and most people won't 
be able to spare any more of thenormal set. 
The chance to use mnemonic representa- 
tions of the printer features is not to be 
missed. The Editor has its own fount of 
characters, produced by pressing CTRL 
before alpha keys; the screen character is 
the normal alpha one, with a bar over the 
top (overscore or overline). CTRL-B pro- 
duces B on the screen; you can find the 
corresponding decimal or hexadecimal 
code in the character set and keys list in the 
QL User Guide. 

For most purposes, then, you need only 
twokeys for any printer feature to be called. 
Unfortunately, some combinations of 
CTRL and alpha have operating system 
definitions, and cannot be used. An obvi- 
ous example is CTRL-C, which is the task- 


switching command, These combinations 
have to be entered as CTRL-SHIFT-alpha. 
If you don’t like doing this, try choosing 
another mnemonic for the feature con- | 
cerned; use CTRL-S (‘small’) for condensed 
print, rather than CTRL-SHIFT-C, for ex- 
ample. 


Choice of method 


The sample Driver_dat file has much the 
same features in it as the sample Quill 
Printer_dat file,as would be expected since 
the aim is to get the same printed output. 
Like Install_bas, you can enter the codes in 
various ways, your choice of method being 
influenced by personal familiarity with 
code systems as well as the presentation in 
the printer manual. I find decimal the least 
complex; the only difference from Quill 
here is that the # prefix has to be used with 
all decimal codes. 

The separating comma between codes is 
mandatory, as before. 

All lines giving instructions to the print 
program (Edtprt_bin) must start with a 
semi-colon; lines which are forinformation 
purposes only — equivalent to SuperBasic 
REMark lines — must start with a period / 
full stop. 

There are no serious restrictions on how 
many instructions are passed to the printer, 
and the sample includes a set of code- 
changes for printing out characters from 
other European languages. If you check 
the keyboard codes given for such charac- 
ters in the OL User Guide list against the 
characters produced on the screen, you 
may notice they do not all agree, and some 
experimentation may be required. The 
entries are all PXL (affecting one line only) 
because they are to take effect only at the 
point the code is met in the text. This 
avoids strange hangover effects in subse- 
quent printing. The entries for typestyle 
changesare all PXG (global) in effect. They 
can be compared directly with those in the 
sample Printer_dat file. One slight differ- 
ence between Quill and The Editor is that 
combining a Quill embedded command 
witha Translate command does not always 
produce the desired result, whereas all the 
Editor commandsare of the Translate form 
and canbe combined as required. The Bold 
feature was incorporated into other feature 
calls in Printer_dat, as using F4-B with, 
say, |} for medium bold Pica does not seem 
to work. 


Headers and footers 


Themargins for page headers and footers 
(PHM and PEM) are set to give a total of 70 
lines when added to the text length, PPL. 
You can re-specify these parameters on 
individual pages of a document, but don’t 
changejust one without making a balancing 
change to one or both of the others. That is, 
the basic text length of 60 lines could be 
changed to, say, 63, to accommodate one 
page where it is essential to get certain text 
onto that page rather than the next one, but 
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there would have to be a corresponding 
reduction of 3 in PHM or PFM, or split 
between the two of them. PHM is best left 
at 2, or 1 at the minimum, to allow the 
printer time to get the paper moving pre- 
cisely, before it prints the first few lines of 
text. 


Sample Driver_dat file for Kaga-Taxan 
KP-810 (Canon PW1080a) printer 

.18 May 88:Driver_dat 

sName KP-810 


;PDV serl 

;PBD 9600 

sPPA #27 ,#54,#27, 
:PPO #27 #64 
sPHM 2 

;PFM §& 

PPL 60 

;PLM 8 

;sPEL #10 

scSS 

jPXL £#96;46 
jPXL #178427, #82,#4 #92, #27 482,40 
SPXL a;#128;#27,#82 42,4123, #27 #82,#0 
sPXL G;#132;427,882,42,4124,427 #82,#0 
“PXL Uj4135;4#27 ,#82,#2,4#125,427 482,40 
sPXL A; #160;427 482,42, 491 #27 482,40 
3PXL O; #164427 482,42, #92 #27, #82,#0 
sPXL U:#167;#27 #82,#2,#93,427,#82,#0 
SPXL 8;#156;#27,#82,#2,4126,#27,482,#0 
sPXL @:#144-427 #82,41,#125,427,482,40 
sPXL 641315427 #82,41,4123,427 482,40 
sPXL aj] 41 #27 482,41 464,427 482,40 
IPXL cp#1 363427 ,482,41 492,427,482, 40 
sPXL 341543427, 482,41 124,427 #82 40 
SPXL °:#186;#27 482,41 ,#91,#27,#82,#0 
)PXL §;#182;#27 482,41 #93 #27, #82 40 
sPXL Pt:#157 #27 #82,#7 835,427 ,#82,#0 
7PXL j#179;#27 482,47 491 #27 482,80 
sPXL N;#181;427 482,47 492,427,482 40 
SPXL o #1 80;#27,#82,#7 #93, #27 482,40 


77 #27 ,#73,#1 
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sPXL fi;#137 #27 #82,4#7,#124,427,482,#0 
sPXG Double Strike;#2;#27 #71 
:sPXG Underline;#21;#27,#45,41 
jPXG Superscript;#8;#27 #83,#0 
iPXG Subseript;#1 1 #27,483,41 
;PXG Proportional NLO;#14;#27,#40, 
#27 #112,41 

;PXG Double Strike Proportional Enlarged 
Pica; #7 #27 433 448 #27,#112,#1 

;PXG Double Strike Enlarged Elite;#5; 
427,433,449 
;PXG Condensed Pica;#19;#27,#33,#4 
;PXG Medium Pica;#13;#27 433,#36 
;PXG Proportional Pica;#16;#27,#33,#0, 
#27,#112,#1 

sPXG Italics;#20;#27 #52 

SPXG All of f;415;427,453 427,433 411 427, 
#84, #27, #45 40,427 472,427 ,#112,40 


The keyings mostly havesome mnemonic 
content — CTRL-B for B, CTRL-S for small 
(condensed), CTRL-H for high (super- 
script). CTRL-1 is used to indicate the end 
of a page, so is unavailable for low (sub- 
script); CTRL-K has been used, as being 
the nearest, alphabetically, to H (for high). 
To distinguish between the two enlarged 
typestyles, CTRL-G has been v sed for Pica 
(giant — because it is the largest available) 
and CTRL-E for Elite (enlarged). CTRL-M 
suits medium (enlarged-condensed). 
CTRL-I is a system code, so CTRL-T has 
been used for iTalics. Hopefully, suggest- 
ing such key combinations will have the 
effect of goading users into generating their 
own, better ones! 

Several methods of introducing code 
translations have been suggested by read- 
ers over the past year, and some of them 
may suit individual users better than the 
method given in Part 1 of this article. For 
instance, the ESC code needed as a pre- 
liminary to get a printer to change most 


features can be entered into a document by 
typing CTRL-;, whichappears on the screen 
as U. Tomake the keying clear—hold down 
the CTRL key and tap the ; key. These are 
the keys which produce the decimal code 
155. The printer converts this code to the 
one for ESC. So, when you want italics, 
type a4" into your text (your printer may 
require the second code in a somewhat- 
different format). My own feeling is that 
the method described in this article is more 
appropriate for users who want the selec- 
tion of features to be as automatic as possi- 
ble, but the method just mentioned may be 
preferable for users with more knowledge | 
of the mechanism of getting printed out- 


put. 


Easy and difficult 


There are two other programs to con- 
sider when talking of printer drivers. fext8’ 
makes life both easy and difficult. As an 
ordinary user, there is nothing you can do 
toalterthe supplied drivers, and that makes 
life much easier than it is with Quill or The 
Editor. Should you have a real need to 
change a supplied driver, you would have 
to either ask the suppliers of the program 
to write it for you, or ask for the assembly 
code of the driver and make the changes to 
that yourself. For a user with sufficient 
programming knowledge, and having a 
suitable assembler program, making 
changes this way is straightforward. The 
other program is due on the scene any day 
now, at the time of writing — Perfection. 
The printer driver for this can be tailored 
by the ordinary user, but comments on 
doing this will have to wait until the print 
selection of the program has been finalised, 
and I've had time to work with it. 


INFORMATION 

Serial-parallel interface: 

Miracle Systems Ltd., 
25 Broughton Way 

Osbaldwick 

York YO1 3BG. 

Tel (0904)-423986 


The Editor: 

Digital Precision Ltd. 
222 The Avenue 
Chingford 

London E4 9SE. 

Tel. (081) 527-5493 


Text8?; 

Software’? 

33 Savernake Road 
London NW3 2JU. 
Tel. (071) 267-2025 


Psion 2.35 programs: 
T.K. Computerware 
Stone Street 

North Stanford 
Ashford 

Kent TN25 6DF. 
Tel. (030381)-2801 
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SUBSCRIBE 10: SIIGLAR OL WORK 
ET THI 

See OCKABLE DISK BANK 

FOR 40 3.5 INCH 


DISKS 


ABSOLUTELY 
FREE!! 


| Please send me r my 12/24 month subscription to SINCLAIR QL| Fill in the coupon on 
WORLD and my free disk bank. eee 

: | enclose my cheque/money order for £ made payable | the left and send it with 

| to MCPC Ltd or debit my Access/Visa card. ; your remittance to: 

: PML ca scnlonabacnBx aie ogriians ESP CIE ssicins satsnnaisrccisnsconssnene | MSM Subscriptions 

! | Department, Lazahold 

| 


PRGTIUD ‘seen seakienasamermesivensst PSC OGS sccccnsscasesecnsenssvvon estas | Ltd, P.O. Box 10, Roper 

| Street, Pallion Indus- 
trial Estate, Sunder- 
land SR4 6SN. (The 
first issue of a new sub- 
scription to be delivered 
will be one or two issues : 
after the one you placed 


£23.40 12mth EUROPE £32.90 12mth RESTOF £40.90 12mth BMNZO1URm order in.) 


£46.80 24mth £65.80 24mth WORLD £81.80 24mth 
OVERSEAS RATES INCLUDE AIRMAIL SERVICE ee Closes 31st July | 


